文档介绍:用友通信能力平台(嘟嘟)
接口规范书
目录
1 变更记录 1
2 范围 1
3 使用方法 1
4 规范组成文件 1
5 缩略语 1
6 isv开发接入流程说明 1
7 接口描述 3
账号相关 3
账号的临时密钥获取(更新)接口 3
组织账号注册接口 5
账号充值接口 7
能力调用 9
发起多方通话接口 9
通话中添加参与人接口 11
通话中踢出参与人接口 12
结束多方通话接口 14
运营信息 16
会议状态接收接口 16
话单接收接口 18
8 接口数据字典 20
SHA1加密算法(Java版) 20
话单返回码字典 21
计量单位字典 21
账号状态字典 21
会议状态(call_state)字典 22
变更记录
变更日期
功能点
变更内容
提出人
变更人
2015-6-18
文档建立
秦福欣
2015-7-20
相关接口修改等工作
危东
范围
本规范仅针对能力平台系统与已有目标系统之间的接口关系提出规范要求。
使用方法
按照不同的业务场景,选择不同的接口进行数据传输、同步。
规范组成文件
无。
缩略语
英文缩写
英文名称
中文名称
HTTP
Hypertext Transfer Protocol
超文本传输协议
isv开发接入流程说明
流程图:
1.      应用标识(account_identifer),应用下的永久密钥(key_permanent)(key_temp)
 
2.      应用标识(account_identifer)和临时密钥(key_temp)通过程序生成签名(sign)和时间
戳(timestamp),(pany_identifer可自行设置)
 
3.      注册成功,接口返回“组织账号标识(account_identify)”、“组织账号的永久密钥(key_permanent)”和“临时密钥(key_temp)”
 
4.      通过组织账号标识(account_identify)和临时密钥(key_temp)通过程序生成签名(sign)和时间
戳(timestamp)
 
5.      组织账号标识(account_identify)、签名(sign)和时间戳(timestamp)(userId可自行设置)
 
6.      发起成功返回一个sessionId,、、、、
接口描述
账号相关
账号的临时密钥获取(更新)接口
服务名称
英文名称:ountkey
中文名称:更新组织账号的临时密钥接口
服务描述
服务提供费方:能力平台
输入参数
参数信息(ountkey):
请求头
无
请求体
序号
必填
字段名称
字段描述
数据类型
备注
1
Y
account_identify
组织的账号标识
VARCHAR(100)
通过调用账号注册接口获取
2
Y
timestamp
时间戳
VARCHAR(20)
3
Y
sign
认证码 
VARCHAR(50)
生成规则: SHA1(account_identify+key_permanent +timestamp),
key_permanent是账号所对应的永久密钥,通过调用账号注册接口获取
demohttp://open./httpIntf/?account_identify=F180B5A48560278787E6D52881F10853&sign=e73e94d1b8c59b20412ab8527e12ba4b7e63cff7&timestamp=1430274569132
接口接入注意事项
注册组织账号时,会返回与之对应的临时密钥、永久密钥。
永久密钥用于调用更新临时密钥接口时生成认证串。
临时密钥用于调用发起通话、充值等接口时生成认证串。
临时密钥可更根据实际需求调用该接口更新。
输出参数
参数信息:
响应头
无
响应体(JsonObject)
序号
字段名称