列出聯絡人

const response = await fetch("https://api.brightalk.ai/contacts?limit=20", { method: "GET", headers: { Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`, "Brightalk-Version": "2026-07-16", }, }); console.log(response.status, await response.json());

import os import requests response = requests.request( "GET", "https://api.brightalk.ai/contacts?limit=20", headers={ "Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}", "Brightalk-Version": "2026-07-16", }, ) print(response.status_code, response.json())

{ "data": [ { "id": "con_demo_001", "external_id": "customer-8421", "source": "public_api", "name": "Example Customer", "phone_number": "+12025550123", "email": "customer@example.com", "company": "Example Co.", "role": "Operations Manager", "city": "Taipei", "country": "TW", "created_at": "2026-07-20T01:00:00Z", "updated_at": "2026-07-20T01:00:00Z" } ], "next_cursor": "<string>" }

授權

Authorization

string

header

必填

Use a private-beta server credential in the Authorization header.

標頭

Brightalk-Version

string

預設值:2026-07-16

選擇以日期為基礎的 API 版本。省略時會使用組織鎖定的私人測試版預設值。

Allowed value: "2026-07-16"

X-Request-Id

string

由呼叫端產生且符合 [A-Za-z0-9._:-]{1,64} 的關聯值。無效值會被取代。

Maximum string length: 64

Pattern: ^[A-Za-z0-9._:-]{1,64}$

查詢參數

limit

integer

預設值:20

要傳回的資源數量。預設為 20，上限為 100。

必填範圍: 1 <= x <= 100

cursor

string

前一頁傳回的不透明游標。

Required string length: 1 - 2048

external_id

string

Required string length: 1 - 255

source

string

Pattern: ^[a-z][a-z0-9_-]{0,63}$

created_after

string<date-time>

created_before

string<date-time>

回應

已傳回聯絡人。

data

object[]

必填

Show child attributes

next_cursor

string | null

必填

開始使用

API 基礎

核心概念

操作指南

發布資訊

API 參考

授權

標頭

查詢參數

回應