# 语音呼叫API-获取主叫号码信息

#### 接口说明

获取用户拥有的主叫号码列表信息。

#### 请求参数

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| service | string | 是 | App.Sip\_Disnum.getDisnumberInfo |
| token | string | 是 | 通过授权接口获取的token |
| status | int | 是 | 1:启用（默认）、2:禁用、3:全部 |
| autocall | int | 是 | 是否预测外呼号码：1:不限（默认）、2:是、3:否|
| disnumber | string | 否 | 主叫号码，多个主叫号码用英文逗号隔开，不传时获取所有 |
| areacode | string | 否 | 号码区号 |

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

    <?php
        $apiUrl = 'http://127.0.0.1:8080';
        $postFields = [
            'service'   => 'App.Sip_Disnum.getDisnumberInfo',
            'token'     => 'ABCDEFG',
            'status'    => 1,
            'autocall'  => 1,
            'disnumber'    => '0755111,0755222',
            'areacode'  => '0755'
        ];
        $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": 1,
              "currentpage": 1,
              "itemsperpage": 20,
              "disnumbers": [
                  {
                      "disnumber": "2026080210",
                      "areacode": "62",
                      "disnumbertype": "mob",
                      "concurrent": 0,
                      "status": 1018,
                      "autocall": "yes",
                      "message": "号码已启用"
                  }
              ]
          },
          "reqtime": 1789628860,
          "rsptime": 1789628860
      },
      "msg": ""
    }
    

#### 返回参数说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| result | object | 号码对象信息 |
| -totalitems | int | 分机总数                   |
| -currentpage | int | 当前页码                   |
| -itemsperpage | int | 每页默认值                   |
| -disnumbers | array | 号码列表数组 |
| —disnumber | string | 主叫号码 |
| —areacode | string | 区号 |
| —disnumbertype | string | 号码类型 tel:固话 mob:手机 |
| —concurrent | int | 号码并发, 0 表示不限制 |
| —status | int | 号码状态码，1018：启用、1019：禁用、1020：不存在 |
| —autocall | string | 是否预测外呼号码 yes:是 no:否 |