接口说明

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

说明：由于运营商设备针对按键传输存在异常，可能存在按键重复的现象，故在设置分机时请不要设置紧邻的数字一致，比如8807,6788，8088等分机。建议设置为紧邻两位不重复的分机，比如5658，5659，5670（中间5660-5669不建议使用）

调用形式

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

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

调用方式

【POST】

传入参数

序号 名称 是否必填 说明
1 appver 是 应用版本值：1
2 user 是 用户名
3 secret 是 计算sercert请阅读1 2 3(不能直接拿3获取到的token直接赋值给当前接口的secret进行调用）
4 timestamp 是 当前时间，服务端会验证时间有效性，如果与服务端时间差大于 10 分钟则请求无效。
5 account 是 企业400/LN号码
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：顺序
turn:轮流平均

回应参数

序号 名称 是否必填 说明
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
}
文档更新时间: 2025-09-24 09:40   作者：admin