# 语音呼叫API - 发起语音呼叫

#### 接口说明

对某个号码直接发起呼叫，多数适用于网页上点击“呼叫”后调用接口。

#### 请求方式

POST，form-data格式

#### 请求参数

| 参数名        | 类型     | 是否必须 | 说明                     |
| :--------- | :----- | :--- | :--------------------- |
| service    | string | 是    | App.Sip\_Call.MakeCall |
| token      | string | 是    | 通过授权接口获取的token         |
| extnumber  | string | 是    | 分机号                    |
| destnumber | string | 是    | 目标号码                   |
| disnumber  | string | 否    | 主叫号码(用户手机上显示的来电号码)，必须使用系统配置的主叫号码，否则呼叫失败，留空则随机取一个主叫号码      |
| userid     | string | 否    | 自定义参数(员工id)            |
| memberid   | string | 否    | 自定义参数(会员id)            |
| customuuid | string | 否    | 自定义参数(客户id)            |
| ext | string | 否    | 自定义参数(扩展参数)             |

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

```
<?php
    $apiUrl = 'http://127.0.0.1:8080';
    $postFields = [
        'service'   => 'App.Sip_Call.MakeCall',
        'token'     => 'ABCDEFG',
        'extnumber'  => 'abcdefg',
        'destnumber'  => 'abcdefg',
        'disnumber'  => 'abcdefg',
        'userid'  => 'abcdefg',
        'memberid'  => 'abcdefg',
        'customuuid'  => 'abcdefg',
        'ext'  => '{"aa":11}',
    ];
    $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": "呼叫命令发送成功",
            "reqtime": 1581389402,
            "rsptime": 1581389402
        },
        "msg": ""
    }