1.语音验证码
语音验证码是有联云融合通讯开放平台提供的一种语音通知能力,可替代或辅助短信验证码使用,拥有更即时和实时反馈的机制以满足实时要求更高的身份认证类服务。使用此REST API实现语音验证码功能。
请通过HTTPS POST方式提交请求,有联云融合通讯开放平台收到请求后,向对象电话终端发起呼叫,接通电话后将播放指定语音验证码序列
请求
请求地址
/Accounts/{accountSid}/Calls/voiceCode
请求包头
详情请查阅统一请求包头,并使用开发者账号进行验证。
请求包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
appId | String | 必选 | 应用Id |
digits | String | 必选 | 验证码内容,为数字0~9,字母a~z,特殊字符!(感叹号)、~(波浪号)、@(at)、#(井号)、%(百分号)、$(美元符)、¥(元符号)、^(次方符)、&(与符号)、*(星号)、((左小括号)、)(右小括号)、.(点)、_(下划线)、+(加号)、|(竖线)、-(减号)、<(左尖括号)、>(右尖括号)、?(问号)、[(左中括号)、](右中括号)、{(左大括号)、}(右大括号),长度4-8位。说明:字母不区分大小写,特殊字符均为英文状态下输入(¥符号除外)。 |
callee | String | 必选 | 接收号码 |
XML请求示例
/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/voiceCode.xml?sig=C80B3CA83E40F3947C41B15BE0523FB2 Host:app.youlianyun.com Accept:application/xml Content-Type:application/xml;charset=utf-8 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY= <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <appId>950a97bce77b885b747536a1e3887465</appId> <digits>7116</digits> <callee>18612345678</callee>
JSON请求示例
/Accounts/1784fd62ae354a1eca54f8b34e5a9baf/Calls/voiceCode?sig=C80B3CA83E40F3947C41B15BE0523FB2 Host:app.youlianyun.com Accept:application/json Content-Type:application/json;charset=utf-8 Authorization:MTc4NGZkNjJhZTM1NGExZWNhNTRmOGIzNGU1YTliYWY6MjAxNTEwMTMxNjA3NTY= { "appId" : "950a97bce77b885b747536a1e3887465", "callee" : "18612345678", "digits" : "4342", }
响应
响应包体
属性 | 类型 | 约束 | 说明 |
---|---|---|---|
respCode | String | 必选 | 请求状态码,取值200(成功) |
callId | String | 必选 | 一个由32个字符组成的唯一电话标识符 |
reason | String | 必选 | 回调结果 |
XML响应示例
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <respCode>200</respCode> <callId>48dcc7d44fb274f316924bedd7696645</callId> <reason>success</reason>
JSON响应示例
{ "respCode" : "200", "callId" : "31d7ca243c406a81611910db21b68876", "reason" : success }