添加分机接口
接口地址
POST http://m.icsoc.net/v2/wintelapi/phone/add
接口参数
| 参数 | 说明 | 备注 |
|---|
| pho_num | 分机号 | 当pho_type=1时, 必须，当pho_type=5时，pho_mum和pho_start/pho_end必须填一个 |
| pho_type | 分机类型（1、PSTN电话 5、SIP远程分机） | 必须 |
| pho_start | sip分机号码开始段 | 当pho_type=5时，pho_mum和pho_start/pho_end必须填一个 |
| pho_end | sip分机号码结束段 | 当pho_type=5时，pho_mum和pho_start/pho_end必须填一个 |
| passtype | 密码类型（1、随机 2、固定， 默认：随机） | 当pho_type=5时，必须 |
| pho_pass | 分机密码 | 当pho_type=5 and passtype=2时， 必须 |
结果编码说明
| code | 说明 |
|---|
| 401 | 企业代码为空 |
| 402 | 企业代码不存在 |
| 403 | 电话类型值有误(1,5) |
| 404 | 电话号码为空 |
| 405 | 结束日期不正确 |
| 406 | 开始分机号格式有误 |
| 407 | 结束分机号格式有误 |
| 410 | 请求重载分机地址失败 |
| 411 | 您添加的分机号已存在 |
| 200 | ok |
结果示例
正常返回
{'code':200, 'message':'ok'}
#### 当批量添加时，如果添加分机已存在情况时返回
{
"code":200,
"message":"ok",
"data":{
"411":[
{
"pho_type":"1",
"pho_num":"8888"
}
]
}
}
获取分机列表数据接口
接口地址
POST http://m.icsoc.net/v2/wintelapi/phone/list
接口参数
| 参数 | 说明 | 备注 |
|---|
| info | 筛选条件，示例：{"filter":{"phone":8989,"is_bind":0,"pho_type":5}} | 可选 |
参数filter中字段说明
| 字段 | 说明 |
|---|
| pho_num | 非必须,分机号 模糊搜索 |
| is_bind | 非必须,是否已经被坐席占用 1:占用 0:没有占用 |
| pho_type | 非必须,分机类型 1:PSTN 5:SIP |
结果编码说明
| code | 说明 |
|---|
| 401 | 企业代码为空 |
| 402 | 企业代码不存在 |
| 403 | info格式非json |
| 200 | ok |
结果示例
{
"code": 200,
"message": "ok",
"total": "2",
"page": 1,
"totalPage": 1,
"data": [{
"id": "920",
"pho_num": "13001937852",
"pho_type": "1",
"pho_pass": "",
"type_msg": "PSTN\u7535\u8bdd",
"sip_number": "",
"comment": "",
"is_bind": 1
}, {
"id": "902",
"pho_num": "15201164261",
"pho_type": "1",
"pho_pass": "",
"type_msg": "PSTN\u7535\u8bdd",
"sip_number": "",
"comment": "",
"is_bind": 1
}]
}
结果字段说明
| 字段 | 说明 |
|---|
| id | 分机号ID |
| pho_num | 分机号 |
| pho_type | 分机类型 |
| pho_pass | 分机密码 |
| type_msg | 类型名称 |
| sip_number | SIP号 |
| comment | 备注 |
| is_bind | 是否被坐席占用 1 是 0 否 |
删除分机接口
接口地址
POST http://m.icsoc.net/v2/wintelapi/phone/delete
接口参数
| 参数 | 说明 | 备注 |
|---|
| ids | 分机ID集合，示例：1,3,10 | 必须 |
结果编码说明
| code | 说明 |
|---|
| 401 | 企业代码为空 |
| 402 | 企业代码不存在 |
| 403 | ids格式不正确或为空 |
| 405 | 请查看分机是否有坐席在使用 |
| 410 | 请求重载分机地址失败 |
| 500 | 总结果 |
结果示例
{'code':500, 'message':'总结果', 'data':{'success':[1,23,4],'fail':[2,3]}}
分机注册信息查询接口
接口地址
POST http://m.icsoc.net/v2/wintelapi/advanced/phone/info
接口参数
| 参数 | 说明 | 备注 |
|---|
| phone | 分机号，示例：40,80 | 必须 |
| page | 当前页 | 默认：1 |
| rows | 每页条数 | 默认：10 |
| sort | 排序规则 | 默认：asc |
| order | 排序字段 | 默认：id（系统） |
结果示例
{
"total": 1,
"page": 1,
"records": "4",
"rows": [
{
"pho_num": "4017",
"cur_now": "离线",
"ag_name": "",
"ag_num": "",
"cur_time": "",
"cur_format_time": "",
"realm": "",
"ping_ms": "",
"uac": "",
"src_host": ""
},
{
"pho_num": "4018",
"cur_now": "离线",
"ag_name": "",
"ag_num": "",
"cur_time": "",
"cur_format_time": "",
"realm": "",
"ping_ms": "",
"uac": "",
"src_host": ""
},
{
"pho_num": "4019",
"cur_now": "离线",
"ag_name": "",
"ag_num": "",
"cur_time": "",
"cur_format_time": "",
"realm": "",
"ping_ms": "",
"uac": "",
"src_host": ""
},
{
"pho_num": "4020",
"cur_now": "离线",
"ag_name": "",
"ag_num": "",
"cur_time": "",
"cur_format_time": "",
"realm": "",
"ping_ms": "",
"uac": "",
"src_host": ""
}
],
"code": 200,
"message": "ok"
}
