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

#### 接口说明

获取当前用户拥有的分机组列表

#### 请求方式

POST，form-data格式

#### 请求参数

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| service | string | 是 | App.Sip\_Extgroup.GetExtgroupInfo |
| token | string | 是 | 通过授权接口获取的token |
| name | string | 否 | 分机组名，为空则获取所有 |
| currentpage  | int    | 否    | 页数，默认：1                                                           |
| itemsperpage | int    | 否    | 每页数量，默认：10，最小：1；最大：1000                                           |

#### 接口请求示例（PHP）

    <?php
        $apiUrl = 'http://127.0.0.1:8080';
        $postFields = [
            'service'   => 'App.Sip_Extgroup.GetExtgroupInfo',
            'token'     => 'ABCDEFG',
            'name'  => 'abcdefg',
        ];
        $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": 2,
            "currentpage": 1,
            "itemsperpage": 20,
            "extgroups": [
                {
                    "id": 226,
                    "name": "kefu03",
                    "status": 1041,
                    "createtime": "2026-09-17 07:45:54",
                    "message": "坐席组已启用"
                },
                {
                    "id": 227,
                    "name": "kefu01",
                    "status": 1041,
                    "createtime": "2026-09-17 09:00:50",
                    "message": "坐席组已启用"
                }
            ]
        },
        "reqtime": 1789610690,
        "rsptime": 1789610690
      },
      "msg": ""
    }
    

#### 返回字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| result | object | 分机组对象 |
| -totalitems | int | 分机总数                   |
| -currentpage | int | 当前页码                   |
| -itemsperpage | int | 每页默认值                   |
| -extgroups     | array  | 分机组列表数组                   |
| —id | string | 分机组id |
| —name | string | 分机组名 |
| —status | string | 分机组状态码，1041：启用、1042：禁用 |