第三方應用服務器接收語音驗證碼狀態通知（可選）
呼叫結束之后，云通訊平臺將向語音驗證碼請求中配置的respUrl地址發送語音驗證碼狀態通知。
1.1 語音驗證碼狀態通知
語音驗證碼掛機后給應用側的通知消息。
1.1.1 請求包頭
| 屬性 | 類型 | 約束 | 描述 | 舉例 |
|---|---|---|---|---|
| Method | String | 必選 | HTTP方法 | POST |
| URL | String | 必選 | 地址URL | /{path} |
| Host | String | 必選 | 服務器地址 | |
| Content-Type | String | 必選 | 類型 | text/plain |
| Content-Length | String | 必選 | 消息體的長度 | |
1.1.2 請求包體
| 屬性 | 類型 | 約束 | 描述 | 取值 |
|---|---|---|---|---|
| action |
String | 必選 | 表示語音驗證碼 |
VoiceCode |
| callSid |
String | 必選 | 對應接口返回callSid參數，一路呼叫的唯一標示 |
32位字符串 |
| number |
string |
必選 | 外呼號碼 |
|
| state |
String | 必選 | 通話狀態 |
0正常通話 1被叫通話未應答 2外呼失敗 |
| duration |
String |
必選 | 通話時長 |
單位秒 |
| userData | String | 可選 | 用戶私有數據。語音驗證碼接口參數 | |
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 響應示例
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>
判斷發送狀態，重發
語音驗證碼請求的響應中statusCode為"000000"表示請求發送成功。statusCode不是"000000"，表示請求發送失敗；請求成功后在配置的respUrl接收返回的語音驗證碼狀態通知，state為0正常通話 1被叫通話未應答 2外呼失敗。客戶服務端可以根據自己的邏輯進行重發或者其他處理。