华为云隐私通话(AXB)
序言:
首先是需要在华为云上申请隐私通话服务的具体的大家可以去看官方文档:隐私通话接入文档 在这儿呢我主要介绍AXB模式,其他模式(AX、AXYB等)都是大同小异的。
AXB:是指A用户和B用户同时绑定隐私号码X,并且通过X进行通话。注意:1个X号码允许绑定1000对用户号码,但用户号码不可重复。例如,允许同时绑定AXB和CXD,但不允许同时绑定AXB和BXC
话不多说直接开整:
1.首先是绑定接口
绑定接口主要注意他的 msgdgt(签名摘要),主要构成是:
1)把消息头(appkey和ts)、消息体按key的字母原样顺序排序
2)排序后将密钥、消息头(appkey和ts)和消息体的所有key、value串起来以UTF-8编码进行MD5加密,如:MD5(secretkey1value1key2value2..)
3)生成32位大写的摘要字符串,如:BA9854BED1A2986B061E2713F403C752
4)参数释意
参数 |
类型 |
意义 |
是否必传 |
备注 |
appkey |
string |
应用id |
M |
|
ts |
string |
业务时间戳 |
M |
格式yyyyMMddHHmmssSSS,时间采用北京时间,24小时制,精确至毫秒 1)时间格式检查; 2)请求带过来的时间与当前时间比较,前后差值不能超过5分钟; |
msgdgt |
string |
签名摘要 |
M |
MD5摘要 |
requestId |
string |
业务id |
M |
消息请求标识 |
telA |
string |
真实号码 |
M |
|
telX |
string |
小号号码 |
O |
X号码,国内号码格式; mode101模式下,该参数必须携带; mode102模式下,该参数不携带 |
telB |
string |
对端号码 |
M |
|
subts |
string |
绑定时间 |
M |
格式为yyyyMMddHHmmss。时间采用北京时间,24小时制。 |
anucode |
string |
主叫侧放音编码 |
M |
AXB业务时必须设置。固定填写”0,0,0″
放音编码必须包含3个场景的编码。按照“B->X,A->X,其他号码->X”的顺序填写编码,编码之间以逗号分隔。
比如:“1,2,3”表示B->X放音编号为1,A->X放音编号为2, 其他号码->X放音编号为3。 |
anucodecalled |
string |
被叫侧放音编码 |
O |
被叫侧放音编码
被叫放音编码必须包含2个场景的编码。按照“A被叫,B被叫”的顺序填写编码,编码之间以逗号分隔。
比如:“1,2”表示A号码为被叫侧接听时的放音编号为1,B号码为被叫侧接听时的放音编号为2。 |
areacode |
string |
区号 |
O |
去掉“0” 例如:北京(10); mode101模式下,该参数可不携带; mode102模式下,该参数需携带,小号业务系统按区号从资源池选择X号码,接入商根据自己申请的X号码填写对应的区号 |
expiration |
string |
过期时间 |
M |
单位:秒,必须为数字 0:不会自动解绑 非0:自动解绑周期 |
remark |
string |
接入商自有字段 |
O |
接入商自有字段,不能超过30个字节 |
transid |
string |
事务ID |
O |
相同事务ID的幂等操作 |
extra |
json |
扩展参数 |
M |
|
-callrecording |
string |
录音控制 |
M |
仅下列值有效。默认1(开通录音功能)。 1:接通后录音 2:呼叫确认后录音 |
-calldisplay |
string |
来显控制 |
O |
可选。 两个取值组成,A->X,B->X;以“,”隔开,比如“0,1” 取值默认为0(不显示真实号码)。 0:不显示真实号码 1:显示真实号码 |
-callrestrict |
string |
呼叫控制 |
O |
可选。仅下列值有效。默认是1。 1 AXB做呼叫控制,A和B有权限,其他号码无权限,即为现有的AXB 2 AXB的单通控制,A无权限,B有权限,其他号码无权限 3 AXB的单通控制,A有权限,B以及其他号码无权限 6 均无权限 |
-calldisplayshow |
string |
推送被叫来显号码控制 |
O |
可选。仅下列值有效。默认是0。 0 推送中不携带被叫来显号码 1 推送中携带被叫来显号码 |
-callunsub |
string |
解绑推送消息控制 |
O |
可选。仅下列值有效。默认是0。 0 解绑不推送消息 1 解绑推送消息 |
-callpickup |
string |
被叫接通推送事件控制 |
M |
必选。 当前场景必须填1 0 不推送被叫接通事件 1 推送被叫接通事件 |
5)响应参数
参数 |
类型 |
意义 |
是否必传 |
备注 |
subid |
string |
绑定id |
M |
|
telX |
string |
小号 |
M |
|
6)代码实现