技术服务_千寻云通讯

 首页 > API接口 > 语音发送接口（VoiceMT）

API接口

接口名称	语音通知发送接口
接口描述	语音通知
请求内容	INDEX：`http://ip:port/api/sms/voicesend` 或者`https://ip:port/api/sms/voicesend` 完整 URL 实例，如： `http://ip/:port/api/sms/voicesend?userid=100001&ts=1476235100217&sign=54449bb492c2ea2592ea3eceef3d0b47&mobile=13800000000,135000000&ms gcontent=test`
请求方式	POST 或GET
应答方式	JSON
接口协议	HTTP

字段名称	是否必填	说明	数据类型	长度
userid	必填	用户编号，接入方信息唯一标识	String	由平台方分配
ts	必填	时间戳, 5 分钟内有效, 时间戳是指格林威治时间 1970 年 01 月 01 日 00 时 00 分00 秒起至现在的总毫秒数（精确到毫秒）	Long	`System.curren tTimeMillis()`
sign	必填	三个信息字符串拼接，然后md5 算法加密（MD5 用 32 位，值必须要小写进行加密）md5(userid + ts + apikey) 中间无需空格无+号	String	apikey: 由平台方分配
mobile	必填	需要发送的手机号(多个号码以英文逗号“,”分隔) 一次性最多 100 个号码	String	13800000000,135000000,13336000000
msgcontent	必填	语音内容（如果是验证码则只能为数字）	String
language	选填	语种，默认zh-CN 中文	String	暂只支持中文
serviceid	选填	业务代码，0：验证码、1：通知	String
extnum	选填	播报时显示的号码扩展（0-6 位）	String	最长 6 位
time	选填	发送时间(为空表示立即发送，如果定时发送，则需要按yyyyMMddHHmmss 格式，如：20110115105822)	String	yyyyMMddHH mmss
messageid	选填	客户侧唯一消息ID,状态报告推送接口原样带回。	String	最长 32 位

字段名称	说明	数据类型	长度
code	状态码	String	10
msg	状态描述	String	50
data	数据节点	Object
taskid	任务ID,接口返回的taskid，如果接口返回非 0，则不返回data 节点	String	最长 32 位

描述：taskid 是字符串格式，长度最大 32 位，code=0 时才会有data 节点和taskid 字段，单次请求只会返回一个taskid。

{"code":"0","msg":"成功","data":{"taskid":"T1011220639000170512059"}}
{
"code": "0",
"msg": "成功",
"data": {
"taskid": "T1011220639000170512059"
}
}

{
"code": "11",
"msg": "签名信息鉴权失败"
}