根據號碼池Key、呼叫記錄ID、呼叫發起時間等獲取錄音文件的下載鏈接。
接口說明
-
如果在綁定關系中開啟了錄音功能，該綁定關系產生的所有通話均會被錄音，可以通過此接口獲取錄音文件的下載鏈接，下載錄音文件。
-
您可以使用此接口獲取錄音文件的下載鏈接進行錄音文件下載，也可以在控制臺呼叫記錄查詢頁面查詢呼叫記錄，單擊錄音文件操作列的下載下拉項，單擊錄音音頻進行錄音文件下載。
-
在使用此接口前，建議您先明確需要獲取的錄音文件對應的呼叫記錄。 您可以在控制臺呼叫記錄查詢頁面進行查詢，獲取呼叫記錄 ID、呼叫發起時間等信息，或者參考回執消息簡介與配置流程，訂閱回執消息類型為錄音狀態報告（SecretRecording）的消息，該報告消息中的結果字段可以作為此接口的入參。
QPS 限制
本接口的單用戶 QPS 限制為 3000 次/秒。超過限制，API 調用會被限流，這可能會影響您的業務，請合理調用。
PoolKey 和 ProductType 限制
PoolKey 和 ProductType 參數請至少填寫一個，若兩個參數都不填，調用接口時會報錯。建議原阿里大于用戶填 ProductType 參數，阿里云用戶填 PoolKey 參數。
獲取錄音文件步驟：
- 在更新或綁定關系接口中選擇入參需要錄音。
- 在控制臺中訂閱錄音消息回執。
- 錄音消息回執返回后調用 QueryRecordFileDownloadUrl 接口下載錄音。
說明
URL 鏈接的有效期為 2 小時。獲取下載鏈接后請盡快下載錄音文件。
錄音文件的存儲周期是 30 天，僅支持下載 30 天內通話記錄的錄音文件。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| dypls:QueryRecordFileDownloadUrl | get |
|
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| PoolKey | string | 否 | FC10000012345**** | |
| ProductType | string | 否 | 產品類型。取值：
說明
| AXB_170 |
| CallId | string | 是 | 416*********bd50 | |
| CallTime | string | 是 | 呼叫記錄中的呼叫發起時間。 獲取方式如下：
說明
CallTime 不支持傳入時間戳格式的參數。
| 2019-03-05 12:00:00 |
返回參數
示例
正常返回示例
JSON格式
{
"Code": "OK",
"Message": "OK",
"RequestId": "1AB3CEF7-DCBE-488C-9C33-D180982CE031",
"DownloadUrl": "http://secret-axb-reco****cn-shanghai.aliyuncs.com/1000000820******_66647243838006067251************.mp3?Expires=1551******&OSSAccessKeyId=LTAIP00vvvv****v&Signature=tK6Yq9KusU4n********7lg4/WmEA%3D"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|
暫無變更歷史