# 分机管理 - 获取分机列表

#### 接口说明

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

#### 请求方式
POST，form-data格式

#### 请求参数

| 参数名       | 类型     | 是否必须 | 说明                               |
| :-------- | :----- | :--- | :------------------------------- |
| service   | string | 是    | App.Sip\_Sipnum.GetSipnumberInfo |
| token     | string | 是    | 通过授权接口获取的token                   |
| status    | int    | 是    | 分机状态。1:启用（默认）、2:禁用、3:全部          |
| extnumber | string | 否    | 分机号，为空获取所有                       |
| currentpage  | int    | 否    | 页数，默认：1                                                           |
| itemsperpage | int    | 否    | 每页数量，默认：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：禁用 |