1 语音发送接口
1.1 请求方式
POST请求(仅支持POST请求)
1.2 请求地址
https://voice.dahancloud.com/voice/submit
1.3 请求参数
1.3.1 HTTP标准包头字段
Accept:application/json;
Content-Type:application/json;charset=utf-8;
Content-Length:256;
Authorization:” ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDN2M6MxNTABCDE= ”;
sig:”c1f20e7a9733ce94f680c70a1dbabcde”;
属性 |
类型 |
说明 |
sig |
String |
1、使用MD5加密(账户Id + 账户授权令牌 + 时间戳)。其中账户Id和账户授权令牌根据url的验证级别对应主账户。
2、时间戳是当前系统时间,格式"yyyyMMddHHmmss",有效时间为24小时,如:20170904112030 |
Authorization |
String |
验证信息,生成规则详见下方说明
1.使用Base64编码(账户Id + 冒号 + 时间戳)其中账户Id根据url的验证级别对应主账户
2.冒号为英文冒号
3.时间戳是当前系统时间,格式"yyyyMMddHHmmss",需与sig中时间戳相同。
|
1.3.2 请求包体
a)、数据格式
{
“to”:”155********”,
“templateId”:”1”,
“appId”:” c1f20e7a9733ce94f680c70a1dbabcde”,
“datas”:[“123456”,”10”]
}
b)、 请求参数属性描述
属性 |
类型 |
约束 |
说明 |
to |
String |
必选 |
短信接收端手机号码集合,用英文逗号分开,每批发送的手机号数量不得超过500个 |
templateId |
String |
必选 |
模板Id |
datas |
String |
必选 |
用户模板需要传入的参数 |
appId |
String |
必选 |
应用id |
1.4 语音请求提交响应内容
a)、 提交响应数据格式
{
"msg": "语音请求成功",
"msgid": "b7c46a843dde4178b36ab39b24ad4dfe",
"code": "DH:0000",
"time": "2018-07-17 09:25:44"
}
b)、 请求参数属性描述
属性 |
类型 |
说明 |
code |
String |
请求状态码,取值DH:0000(提交成功) |
msgid |
String |
本次提交语音消息唯一标识符 |
time |
String |
消息响应时间 |
msg |
String |
状态描述 |
2 语音状态报告接口
2.1 请求方式
POST请求(仅支持POST请求)
2.2 请求地址
https://report.dahancloud.com/voice/report
2.3 请求参数
2.3.1 HTTP标准包头字段
Accept:application/json;
Content-Type:application/json;charset=utf-8;
Content-Length:256;
Authorization:” ZmY4MDgwODEzYzM3ZGE1MzAxM2M4MDN2M6MxNTABCDE= ”
sig:”c1f20e7a9733ce94f680c70a1dbabcde”
属性 |
类型 |
说明 |
sig |
String |
1、使用MD5加密(账户Id + 账户授权令牌 + 时间戳)。其中账户Id和账户授权令牌根据url的验证级别对应主账户。 时间戳是当前系统时间,格式"yyyyMMddHHmmss"。
2、时间戳有效时间为24小时,如:20170904112030 。 |
Authorization |
String |
验证信息,生成规则详见下方说明
1.使用Base64编码(账户Id + 冒号 + 时间戳)其中账户Id根据url的验证级别对应主账户;
2.冒号为英文冒号;
3.时间戳是当前系统时间,格式"yyyyMMddHHmmss",需与sig中时间戳相同。
|
2.4 返回数据格式
a)、 提交响应数据格式
{
"code":"DH:0000",
"datas":
[{
"duration":0,
"calledTimes":1,
"callee":"155**********",
"msgid":"502f34ea6eae47288bd0917c46d83003",
"statue":"DH:0004",
"description":"无人应答【有振铃,无人接听】"
}],
"msg":"请求成功"
}
b)、 请求参数属性描述
属性 |
类型 |
说明 |
code |
String |
请求状态码 |
msg |
String |
请求状态码对应描述 |
datas |
duration |
String |
拨打持续时间 |
calledTimes |
String |
呼叫次数(呼叫次数最多两次) |
callee |
String |
被叫号码 |
msgid |
String |
消息id |
description |
String |
描述 |