跳转到主要内容

分机管理 - 获取分机列表

接口说明

获取用户拥有的分机列表信息。

请求方式

POST,form-data格式

请求参数

参数名 类型 是否必须 说明
service string 是 App.Sip_Sipnum.GetSipnumberInfo
token string 是 通过授权接口获取的token
status int 是 分机状态。1:启用(默认)、2:禁用、3:全部
extnumber string 否 分机号,为空获取所有
currentpage int 否 页数,默认:1
itemsperpage int 否 每页数量,默认:100,10,最小:1;最大:1000

接口请求示例(PHP)

<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Sipnum.GetSipnumberInfo',
        'token'     => 'ABCDEFG',
        'status'    => 3,
        'extnumber'  => '100001'
    ];
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $apiUrl);
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    $response = curl_exec($curl);
    $curlError = curl_error($curl);
    curl_close($curl);
    var_dump($response);
?>

返回数据结构示例

{
    "ret": 200,
    "data": {
        "status": 0,
        "desc": "成功",
        "result": {
            "totalitems": 5,
            "currentpage": 1,
            "itemsperpage": 100,
            "sipusers": [
                {
                    "extnumber": "9002004",
                    "password": "CNAA9002004",
                    "username": "9002004",
                    "status": 1016,
                    "manualdial": 1,
                    "record": 1,
                    "register": null,
                    "createtime": "2026-09-08 14:47:02",
                    "updatetime": "2026-09-17 11:43:01",
                    "message": "坐席已启用"
                },
                {
                    "extnumber": "9002005",
                    "password": "CNAA9002005",
                    "username": "9002005",
                    "status": 1016,
                    "manualdial": 1,
                    "record": 1,
                    "register": null,
                    "createtime": "2026-09-08 14:47:02",
                    "updatetime": "2026-09-17 11:43:01",
                    "message": "坐席已启用"
                }
            ]
        },
        "reqtime": 1789628957,
        "rsptime": 1789628957
    },
    "msg": ""
}

返回参数说明

参数名 类型 说明
result object 分机列表分页信息
-totalitems int 分机总数
-currentpage int 当前页码
-itemsperpage int 每页默认值
-sipusers array 分机列表数组
—extnumber string 分机号
—password string 分机号登陆密码
—status int 分机状态码,1016:启用、1013:禁用
—register string 分机号注册状态。nreg:未注册;reg:已注册
—manualdial int 直拨状态,1:启用、2:禁用
—record int 录音状态,1:启用、2:禁用