接口说明

本接口支撑批量添加分机号码,上限 1000 个/次。如果分机号码已经存在,则更新为新添加的号码。该接口异步处理语音、分机等文件,存在延迟。

调用形式

https://xtapi.uincall.com/api/call/addExtensionV2.action

说明:5000-5999为内部业务预留使用,请勿使用于业务。

调用方式

【POST】

传入参数

序号 名称 是否必填 说明
1 appver 应用版本值:1
2 user 用户名
3 secret 计算sercert请阅读1 2 3(不能直接拿3获取到的token直接赋值给当前接口的secret进行调用)
4 timestamp 当前时间,服务端会验证时间有效性,如果与服务端时间差大于 10 分钟则请求无效。
5 account 企业400号码
6 data 传入的分机编号和电话号码,JSONArray格式,数据必须使用URL(utf-8)进行编码,详细信息参考样例。分机号码上限1000个。
7 dn 分机编号,仅支持4至6位数字
8 tel 手机号码或者固话号码,手机号码格式:18611334885, 不需要添加0或者区号。固话格式:01053358846,不需要添加任何其它非数字内容。
9 aniVoiceName 被叫接听时给主叫播放的提示音。如果为空,主叫不播放提示音
10 dniVoiceName 被叫接听时给被叫播放的提示音。如果为空,被叫不播放提示音
11 transType 分机下目的码转接策略
ord:顺振
rnd:随机
seq:顺序

回应参数

序号 名称 是否必填 说明
1 errcode 0为成功,其它为失败。
2 errmsg 结果解释。
3 data

使用样例

调用

url:
    http://xtapi.uincall.com/api/call/addExtensionV2.0.action
data:
[{"dn":"1001","tel":"13910445833","aniVoiceName" : "分机_ani.wav","dniVoiceName" : "分机_dni.wav"},{"dn":"1002","tel":"13910445844",aniVoiceName" : "分机_ani.wav","dniVoiceName" : "分机_dni.wav"}]

展开
[
    {
        "dn":"1001",
        "tel":"13910445833"
"aniVoiceName" : "分机_ani.wav"
"dniVoiceName" : "分机_dni.wav"
"transType" : "ord"
    },
    {
        "dn":"1002",
        "tel":"13910445844"
"aniVoiceName" : "分机_ani.wav"
"dniVoiceName" : "分机_dni.wav"
    }
]
data URL编码后:
%5b%7b%22dn%22%3d%221001%22%2c%22tel%22%3d%2213910445833%22%7d%2c%7b%22dn%22%3d%221002%22%2c%22tel%22%3d%2213910445844%22%7d%5d
post数据:
    appver=1&user=4006090002_dev&account=4006090002&timestamp=20160907100100&data=%5b%7b%22dn%22%3d%221001%22%2c%22tel%22%3d%2213910445833%22%7d%2c%7b%22dn%22%3d%221002%22%2c%22tel%22%3d%2213910445844%22%7d%5d &secret=b553c1d4430d2825ac93d1f51d6c658c

响应

{
    "data": null,
    "errmsg": "成功",
    "errcode": 0
}
文档更新时间: 2024-06-06 16:03   作者:admin