API文档

模板语音接口请求方式

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 描述