1 自定義電話語音驗證碼接口請求方式
個性化語音內(nèi)容，由您提供語音文件。語音驗證碼API訪問的地址見Base URL。
1.1 Base URL
生產(chǎn)環(huán)境的Base URL：https://app.cloopen.com:8883
注意：為了確保數(shù)據(jù)隱私，云通訊平臺的REST API是通過HTTPS方式請求。
1.2 業(yè)務(wù)流程說明
1.3 統(tǒng)一請求包頭
URL格式：/2013-12-26/Accounts/{accountSid}/Calls/VoiceVerify?sig={SigParameter}
在URL格式中 {}內(nèi)的內(nèi)容表示為參數(shù)，非{}的內(nèi)容固定不變。
屬性說明：
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| accountSid |
String | 必選 |
開發(fā)者主賬戶ACCOUNT SID。（登陸官網(wǎng)在管理控制臺獲取） |
| SigParameter |
String | 必選 |
REST API 驗證參數(shù)，生成規(guī)則如下 1.使用MD5加密（賬戶Id + 賬戶授權(quán)令牌 + 時間戳）。其中賬戶Id和賬戶授權(quán)令牌根據(jù)url的驗證級別對應(yīng)主賬戶。 時間戳是當(dāng)前系統(tǒng)時間，格式"yyyyMMddHHmmss"。時間戳有效時間為24小時，如：20140416142030 2.SigParameter參數(shù)需要大寫，如不能寫成sig=abcdefg而應(yīng)該寫成sig=ABCDEFG |
1.4 HTTP標(biāo)準(zhǔn)包頭字段（必填）
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Content-Length:256;
Authorization:
屬性說明:
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| Accept |
String | 必選 | 客戶端響應(yīng)接收數(shù)據(jù)格式：application/xml、application/json |
| Content-Type |
String | 必選 | 類型：application/xml;charset=utf-8、application/json;charset=utf-8 |
| Content-Length |
String | 必選 | Content-Length |
| Authorization | String | 必選 | 驗證信息，生成規(guī)則詳見下方說明 1.使用Base64編碼（賬戶Id + 冒號 + 時間戳）其中賬戶Id根據(jù)url的驗證級別對應(yīng)主賬戶 2.冒號為英文冒號 3.時間戳是當(dāng)前系統(tǒng)時間，格式"yyyyMMddHHmmss"，需與SigParameter中時間戳相同。 |
1.5 請求包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| appId | String | 必選 | 應(yīng)用Id |
| verifyCode | String | 可選 | 驗證碼內(nèi)容，為數(shù)字和英文字母，不區(qū)分大小寫，長度4-8位 |
| to | String | 必選 | 接收號碼，被叫為座機(jī)時需要添加區(qū)號，如：01052823298；被叫為分機(jī)時分機(jī)號由'-'隔開，如： 01052823298-3627 |
| displayNum | String | 可選 | 顯示主叫號碼，顯示權(quán)限由服務(wù)側(cè)控制。 |
| playTimes | String | 可選 | 循環(huán)播放次數(shù)，1－3次，默認(rèn)播放1次。 |
| respUrl | String | 可選 | 語音驗證碼狀態(tài)通知回調(diào)地址（必須符合URL規(guī)范），云通訊平臺將向該Url地址發(fā)送呼叫結(jié)果通知。 |
| lang | String | 可選 | 播放的語言類型（暫不支持設(shè)置en，默認(rèn)zh）。取值en（英文）、zh（中文），默認(rèn)值zh。 |
| userData | String | 可選 | 第三方私有數(shù)據(jù)，可在語音驗證碼狀態(tài)通知中獲取此參數(shù)。 |
| playVerifyCode | String | 必選 | 內(nèi)容由多個wav格式文件組成，用";"分隔，云通訊會順序播放文件內(nèi)容。 語音文件在管理控制臺上傳，審核通過之后才可以使用。 放音文件的格式樣本如下：位速 128kbps，音頻采樣大小16位，頻道 1(單聲道)， 音頻采樣級別 8kHz，音頻格式PCM，這樣能保證放音的清晰度。 |
| maxCallTime | String | 可選 | 該通通話最大通話時長，到時間自動掛機(jī) |
1.6 自定義語音模板的XML請求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/Calls/VoiceVerify?sig=C1F20E7A9733CE94F680C70A1DBABCDE HTTP/1.1
Host:192.168.0.1:8883
content-length: 139
Accept:application/xml;
Content-Type:application/xml;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
<?xml version='1.0' encoding='utf-8'?>
<VoiceVerify>
<appId>abcdefghijklmnopqrstuvwxyz123456</appId>
<verifyCode>1a8d9u</verifyCode>
<playTimes>2</playTimes>
<to>13811234567</to>
<displayNum>01052821234</displayNum>
<welcomePrompt>huanying.wav</welcomePrompt>
<maxCallTime>60</maxCallTime>
<playVerifyCode>yanzhengma.wav;1.wav;3.wav;5.wav;9.wav</playVerifyCode>
</VoiceVerify>
用戶收聽的效果是："huanying.wav+yanzhengma.wav+1.wav+3.wav+5.wav+9.wav"
1.7 自定義語音模板的JSON請求示例
POST /2013-12-26/Accounts/abcdefghijklmnopqrstuvwxyz012345/Calls/VoiceVerify?sig=
C1F20E7A9733CE94F680C70A1DBABCDE HTTP/1.1
Host:192.168.0.1:8883
content-length: 139
Accept:application/json;
Content-Type:application/json;charset=utf-8;
Authorization:ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDRmODA3MjAwN2M6MjAxMzAyMDExNTABCDE=
{"appId":"abcdefghijklmnopqrstuvwxyz123456","verifyCode":"1a8d9u","playTimes":"2",
"to":"01052821234","displayNum":"01052821234","welcomePrompt":"huanying.wav","maxCallTime":"60",
"playVerifyCode":"yanzhengma.wav;1.wav;3.wav;5.wav;9.wav"}
用戶收聽的效果是："huanying.wav+yanzhengma.wav+1.wav+3.wav+5.wav+9.wav"
2 響應(yīng)
此步響應(yīng)只表明客戶的語音驗證碼請求發(fā)送成功，不表明運(yùn)營商已經(jīng)呼叫發(fā)送驗證碼成功。
2.1 響應(yīng)包體
| 屬性 | 類型 | 約束 | 說明 |
|---|---|---|---|
| statusCode | String | 必選 | 請求狀態(tài)碼，取值000000（成功），可參考錯誤代碼。 |
| callSid | String | 必選 | 一個由32個字符組成的唯一電話標(biāo)識符 |
| dateCreated | String | 必選 | 電話的創(chuàng)建時間 |
2.2 XML響應(yīng)示例
HTTP/1.1 200 OK
Content-Length: 641
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Response>
<statusCode>000000</statusCode>
<VoiceVerify>
<callSid>a346467ca321c71dbd5e12f627123456</callSid>
<dateCreated>2013-02-01 15:38:09</dateCreated>
</VoiceVerify>
</Response>
2.3 JSON響應(yīng)示例
HTTP/1.1 200 OK
Content-Length: 641
{"statusCode":"000000","VoiceVerify":{"dateCreated":"2013-02-01 15:53:06",
"callSid":" ff8080813c373cab013c94be9fe300c5"}}