中文帮助文档> 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
HTTPS请求方式:
POST

请求包体

属性 类型 约束 说明
appId String 必选 应用Id。
callee String 必选 被叫号码
notifyFileId String 必选 语音文件Id
playTimes String 可选 语音播放次数

响应包体

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

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", 
        "callee": "132xxxxxxxx", 
        "notifyFileId": "1",
        "playTimes": "1"
    }
}
							

JSON响应实例

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