# 语音呼叫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": [
                {
                    "disnumber": "0755111",
                    "areacode": "0755",
                    "disnumbertype": "tel",
                    "concurrent": 0,
					"status":1017,
					"autocall": "no"
                }
            ],
            "reqtime": 1581506241,
            "rsptime": 1581506241
        },
        "msg": ""
    }
    

#### 返回参数说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| result | array | 分机列表数组 |
| —disnumber | string | 主叫号码 |
| —areacode | string | 区号 |
| —disnumbertype | string | 号码类型 tel:固话 mob:手机 |
| —concurrent | int | 号码并发, 0 表示不限制 |
| —status | int | 号码状态 |
| —autocall | string | 是否预测外呼号码 yes:是 no:否 |