云通訊平臺為開發者提供了呼叫結果查詢接口,以便開發者通過此REST API對已發起的一路通話結果進行查詢
REST API:呼叫結果查詢
通過HTTPS GET方式提交請求,云通訊平臺收到請求后,返回操作結果。
1、請求
1.1 請求地址
/{SoftVersion}/Accounts/{accountSid}/CallResult
1.2 請求包頭
請參閱:Rest 介紹》統一請求包頭,使用主賬戶進行驗證
1.3 請求包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
callsid | String | 必選 | 呼叫Id |
1.4 XML請求示例
GET /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/CallResult?sig=12345678&callsid=13121218530277930001000200000004 HTTP/1.1 Accept:application/xml; Host:192.168.0.1:8883 Content-Type:application/xml;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
1.5 JSON請求示例
GET /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/CallResult?sig=12345678&callsid=13121218530277930001000200000004 HTTP/1.1 Accept:application/json; Host:192.168.0.1:8883 Content-Type:application/json;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
2、響應
2.1 響應包體
屬性 | 類型 | 約束 | 說明 |
---|---|---|---|
statusCode | String | 必選 | 請求狀態碼,取值000000(成功),可參考Rest 錯誤代碼。 |
callTime | String | 必選 | 通話時長 |
state | String | 必選 | 呼叫結果,0 成功,1未接聽,2失敗 |
2.2 XML請求示例
HTTP/1.1 200 OK Content-Length:586 >?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response> <statusCode>000000</statusCode> <CallResult> <callTime>23</callTime> <state>1</state> </CallResult> </Response>
2.3 JSON請求示例
HTTP/1.1 200 OK Content-Length:586 {"statusCode":"000000","CallResult":{"state":"1","callTime":"23"}}
文檔更新時間:2016年8月11日