Skip to main content

分机管理

添加分机接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/phone/add

接口参数

字段类型是否必填示例值说明
pho_numString否1002分机号（当pho_type=1时, 必须）
pho_typeInteger是1分机类型（1、PSTN电话 5、SIP远程分机）
pho_startString否5001sip分机号码开始段（当pho_type=5时，必须）
pho_endString否5009sip分机号码结束段（如果填写，则必须大于pho_start值）
passtypeString否1密码类型（1、随机 2、固定， 默认：随机）当pho_type=5时，必须
pho_passString否1分机密码（当pho_type=5 and passtype=2时， 必须）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403电话类型值有误(1,5)
404电话号码为空
405结束日期不正确
406开始分机号格式有误
407结束分机号格式有误
408密码类型错误
410请求重载分机地址失败
411您添加的分机号已存在
412分机号码开始段不能大于分机号码结束段
200ok

结果示例

正常返回

{"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

接口参数

字段类型是否必填示例值说明
infoString否{"filter":{"phone":8989,"is_bind":0,"pho_type":5}}筛选条件

参数filter中字段说明

字段类型是否必填示例值说明
phoneString否1007分机号（模糊搜索）
is_bindInteger否1是否已经被坐席占用（1:占用 0:没有占用）
pho_typeInteger否1分机类型（1:PSTN 5:SIP）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403info格式非json
200ok

结果示例

{
    "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_numberSIP号
comment备注
is_bind是否被坐席占用 1 是 0 否

删除分机接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/phone/delete

接口参数

字段类型是否必填示例值说明
idsString是1,3,10分机ID集合（多个逗号分隔）

结果编码说明

code说明
401企业代码为空
402企业代码不存在
403ids格式不正确或为空
405请查看分机是否有坐席在使用
410请求重载分机地址失败
500总结果

结果示例

{
  "code": 500,
  "message": "总结果",
  "data": {
    "success": [
      1,
      23,
      4
    ],
    "fail": [
      2,
      3
    ]
  }
}

分机注册信息查询接口

接口地址

POST http://m.icsoc.net/v2/wintelapi/advanced/phone/info

接口参数

字段类型是否必填示例值说明
phoneString是40,80分机号（多个逗号分隔）
pageInteger否1当前页（默认：1）
rowsInteger否10每页条数（默认：10）
sortString否asc排序规则（asc:默认递增，desc：降序）
orderString否id排序字段（默认：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"
}