curl --request GET 'https://api.brightalk.ai/recordings/22222222-2222-5222-9222-222222222222' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/recordings/22222222-2222-5222-9222-222222222222", {
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/recordings/22222222-2222-5222-9222-222222222222",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"object": "recording",
"id": "22222222-2222-5222-9222-222222222222",
"call_id": "11111111-1111-4111-8111-111111111111",
"contact_id": "con_demo_001",
"recorded_at": "2026-07-20T01:00:00Z",
"duration_seconds": 92,
"media_type": "audio/mpeg",
"download_url": "<string>",
"download_url_expires_at": "2026-07-20T01:15:00Z"
}取得通話錄音
傳回一筆錄音的中繼資料，以及一個新核發的簽名下載網址。下載網址為短效，請在需要時重新索取，不要快取留待稍後使用。每個回應都包含 Brightalk-Version 與 X-Request-Id；受到速率限制的回應還會提供實際套用之配額群組的計數器。
curl --request GET 'https://api.brightalk.ai/recordings/22222222-2222-5222-9222-222222222222' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/recordings/22222222-2222-5222-9222-222222222222", {
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/recordings/22222222-2222-5222-9222-222222222222",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"object": "recording",
"id": "22222222-2222-5222-9222-222222222222",
"call_id": "11111111-1111-4111-8111-111111111111",
"contact_id": "con_demo_001",
"recorded_at": "2026-07-20T01:00:00Z",
"duration_seconds": 92,
"media_type": "audio/mpeg",
"download_url": "<string>",
"download_url_expires_at": "2026-07-20T01:15:00Z"
}授權
Use a server-side Brightalk API key in the Authorization header.
標頭
選擇以日期為基礎的 API 版本。省略時會使用組織固定的預設版本。
"2026-07-16"由呼叫端產生且符合 [A-Za-z0-9._:-]{1,64} 的關聯值。無效值會被取代。
64^[A-Za-z0-9._:-]{1,64}$路徑參數
不透明的錄音識別碼。 不透明的資源識別碼。
1 - 255"22222222-2222-5222-9222-222222222222"
查詢參數
簽名下載網址的存活秒數覆寫值。預設為 900，範圍必須介於 60 至 3600 之間。在列表操作中，只有搭配 include=download_url 才有意義；未搭配就傳入這個參數，會直接收到 400 validation_error，不會被靜默忽略。在取得單筆錄音時則一律有意義。
60 <= x <= 3600回應
已傳回通話錄音。
取得單筆錄音時所回傳的 Recording：download_url 與 download_url_expires_at 保證會出現，不像列表操作需搭配 include=download_url 才有條件出現。採用組合（allOf）而非重複定義，避免兩個操作在其餘七個欄位上出現分歧。
"recording""recording"
不透明的資源識別碼，由來源資料列推導而來；同一筆通話錄音永遠得到相同值。
1 - 255"22222222-2222-5222-9222-222222222222"
此錄音所屬的通話資源識別碼。若該通話並非透過公開 API 建立（例如來自儀表板、非 API 觸發的自動化，或人工撥號），則為 null。
1 - 255"11111111-1111-4111-8111-111111111111"
不透明的資源識別碼。若此錄音未連結任何聯絡人則為 null。
1 - 255"con_demo_001"
通話發生的時間，為分頁排序鍵。
"2026-07-20T01:00:00Z"
x >= 092
"audio/mpeg""audio/mpeg"
新核發、短效的簽名網址，指向此錄音的 MP3 位元組。列表操作中僅在帶 include=download_url 時才會出現，取得單筆錄音時則一律會出現。請視為不透明值：不要自行組合、解析，也不要在到期後繼續快取使用。
2048download_url 的到期時間；若無 download_url 則不會出現此欄位。
"2026-07-20T01:15:00Z"