第三方應(yīng)用服務(wù)器接收語音驗證碼狀態(tài)通知（可選）
呼叫結(jié)束之后，云通訊平臺將向語音驗證碼請求中配置的respUrl地址發(fā)送語音驗證碼狀態(tài)通知。
1.1 語音驗證碼狀態(tài)通知
語音驗證碼掛機后給應(yīng)用側(cè)的通知消息。
1.1.1 請求包頭
| 屬性 | 類型 | 約束 | 描述 | 舉例 |
|---|---|---|---|---|
| Method | String | 必選 | HTTP方法 | POST |
| URL | String | 必選 | 地址URL | /{path} |
| Host | String | 必選 | 服務(wù)器地址 | |
| Content-Type | String | 必選 | 類型 | text/plain |
| Content-Length | String | 必選 | 消息體的長度 | |
1.1.2 請求包體
| 屬性 | 類型 | 約束 | 描述 | 取值 |
|---|---|---|---|---|
| action |
String | 必選 | 表示語音驗證碼 |
VoiceCode |
| callSid |
String | 必選 | 對應(yīng)接口返回callSid參數(shù)，一路呼叫的唯一標(biāo)示 |
32位字符串 |
| number |
string |
必選 | 外呼號碼 |
|
| state |
String | 必選 | 通話狀態(tài) |
0正常通話 1被叫通話未應(yīng)答 2外呼失敗 |
| duration |
String |
必選 | 通話時長 |
單位秒 |
| userData | String | 可選 | 用戶私有數(shù)據(jù)。語音驗證碼接口參數(shù) | |
1.1.3 請求示例
POST /{path} HTTP/1.1
Host: <ip>:<port>
Content-Type: text/plain
Content-Length: <Len>
<?xml version="1.0" encoding="UTF-8"?>
<Request>
<action>VoiceCode</action>
<number>13800000000</number>
<callSid>1307241452320369000100030000002f</callSid>
<state>0</state>
<duration>30</duration>
</Request>
1.2.1 響應(yīng)示例
HTTP/1.1 200 ok
Date:Wed Nov 9 16:08:57 2011
Content-Length: <len>
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<statuscode>000000</statuscode>
</Response>
判斷發(fā)送狀態(tài)，重發(fā)
語音驗證碼請求的響應(yīng)中statusCode為"000000"表示請求發(fā)送成功。statusCode不是"000000"，表示請求發(fā)送失敗；請求成功后在配置的respUrl接收返回的語音驗證碼狀態(tài)通知，state為0正常通話 1被叫通話未應(yīng)答 2外呼失敗。客戶服務(wù)端可以根據(jù)自己的邏輯進行重發(fā)或者其他處理。