中文帮助文档>Rest API

语音消息

通过HTTPS POST方式提交请求,轻码云开放平台收到请求后,向对象电话终端发起呼叫,接通电话后将播放指定语音验证码序列。

请求地址:
/{SoftVersion}/accounts/{accountSid}/Calls/voiceNotify
验证级别:
主账号验证级别,请求地址中的 {accountSid}代表主账号id(ACCOUNT SID)。
地址样例:
https://api.qingmayun.com/20141029/accounts/823deef8e529477185a52179325b4a62/Calls/voiceNotify?sig=84b81c1d13911dd6cd35e63b4db988e8&timestamp=20141116113918
支持格式:
JSON,XML
HTTPS请求方式:
POST

请求包体

属性 类型 约束 说明
appId String 必选 应用Id。
to String 必选 被叫号码。
type String 必选 0:文本;1:语音ID
content String 必选 当type为0时:文本内容,平台负责将该内容转成语音,呼通指定号码后,播放该语音文件;当type为1时:表示语音ID(语音文件必须先上传)。
toSerNum String 可选

被叫侧显示的号码

playTimes String 可选 语音播放次数。
userData String 可选 自定义参数

响应包体

属性 类型 约束 说明
respCode String 必选 请求状态码,取值00000(成功),具体可参考状态码
callId String 必选 呼叫的唯一标识。
createDate String 必选 电话的创建时间。

XML请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/Calls/voiceNotify?sig=84b81c1d13911dd6cd35e63b4db988e8
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/xml
Content-Type:application/xml;charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<voiceNotify>
  <appId>624e76e6486648cd8be0dee3b5cc9957</appId>
  <type>1</type>
  <to>132xxxxxxxx</to>
  <content>1</content>
  <toSerNum>0755*******</toSerNum>
  <playTimes>1</playTimes>
</voiceNotify>

JSON请求实例

POST /20141029/accounts/823deef8e529477185a52179325b4a62/Calls/voiceNotify?sig=84b81c1d13911dd6cd35e63b4db988e8
&timestamp=20141116113918
Host:api.qingmayun.com
Accept:application/json
Content-Type:application/json;charset=utf-8

{
    "voiceNotify": {
        "appId": "624e76e6486648cd8be0dee3b5cc9957", 
        "type": "1", 
        "to": "132xxxxxxxx", 
        "content": "1",
        "playTimes": "1",
        "toSerNum":"0755****"
    }
}

XML响应实例

<?xml version="1.0" encoding="utf-8"?>
<result>
  <respCode>00000</respCode> 
  <voiceNotify>
  <callId>d6677b4fc4de4cafa349aa682292b824</callId>
  <createDate>2014-12-08 17:28:20</createDate>
  </voiceNotify>
</result>

JSON响应实例

{
    "result": {
        "respCode": "00000", 
        "voiceNotify":{
        "callId": "16bd0ed5541a432885709a4c6ac1dd08", 
        "createDate": "2014-12-08 17:52:01"
        }
    }
}