呼叫狀態(tài)查詢(xún)
云通訊平臺(tái)為開(kāi)發(fā)者提供了呼叫狀態(tài)查詢(xún)接口，以便開(kāi)發(fā)者通過(guò)此REST API對(duì)當(dāng)前一路通話的狀態(tài)進(jìn)行實(shí)時(shí)查詢(xún)。
REST API:呼叫狀態(tài)查詢(xún)
通過(guò)HTTPS POST方式提交請(qǐng)求，云通訊平臺(tái)收到請(qǐng)求后，返回操作結(jié)果。
1、請(qǐng)求
1.1 請(qǐng)求地址
/{SoftVersion}/Accounts/{accountSid}/ivr/call
1.2 請(qǐng)求包頭
請(qǐng)參閱：Rest 介紹》統(tǒng)一請(qǐng)求包頭，使用主賬戶(hù)進(jìn)行驗(yàn)證
1.3 請(qǐng)求包體
| 屬性 | 類(lèi)型 | 約束 | 說(shuō)明 |
|---|---|---|---|
| Appid | String | 必選 | 應(yīng)用Id |
| callid | String | 必選 | 呼叫Id |
| action | String | 可選 | 查詢(xún)結(jié)果通知的回調(diào)url地址 |
1.4 XML請(qǐng)求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= 13421304281638380001000000000001 HTTP/1.1 Accept:application/xml; Host:192.168.0.1:8883 content-length: 139 Content-Type:application/xml;charset=utf-8; Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE= <?xml version="1.0" encoding="UTF-8"?> <Request> <Appid>ff8081813fc747ee013fc12345678</Appid> <QueryCallState callid ="13421304281638380001000000000001"/> </Request>
1.5 JSON請(qǐng)求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/ivr/call?sig=155EAA68C5DFB6B762A42D88F406ABCD&callid= 13421304281638380001000000000001 HTTP/1.1
Accept:application/json;
Host:192.168.0.1:8883
content-length: 139
Content-Type:application/json;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
{"Appid":"ff8081813fc747ee013fc12345678","QueryCallState":{"callid":"14092410343310310001000400000047"}}
2、響應(yīng)
2.1 響應(yīng)包體
| 屬性 | 類(lèi)型 | 約束 | 說(shuō)明 |
|---|---|---|---|
| statusCode | String | 必選 | 請(qǐng)求狀態(tài)碼，取值000000（成功），可參考Rest 錯(cuò)誤代碼。 |
| callSid | String | 必選 | 呼叫Id |
| state | String | 必選 | 呼叫狀態(tài) 0：通話結(jié)束， 1：通話中 |
2.2 XML請(qǐng)求示例
HTTP/1.1 200 OK Content-Length:586 <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Response> <statusCode>000000</statusCode> <callSid>029340934823840303948889933</callSid> <state>0</state> </Response>
2.3 JSON請(qǐng)求示例
HTTP/1.1 200 OK
Content-Length:586
{"statusCode":"000000","state":"1","callSid":"14092410343310310001000400000047"}
文檔更新時(shí)間：2016年8月11日