# 预测式外呼 - 设置预测试外呼任务状态接口

#### 接口说明

设置预测试外呼任务的状态。

#### 请求参数

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| service | string | 是 | App.Sip\_Yccall.TaskSet |
| token | string | 是 | 通过授权接口获取的token |
| taskid | string | 是 | 创建任务时返回的唯一id |
| taskstatus | int | 是 | 设置任务状态 1:开启、2:暂停、3:结束 |

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

    <?php
        $apiUrl = 'http://127.0.0.1:8080';
        $postFields = [
            'service'   => 'App.Sip_Yccall.TaskSet',
            'token'     => 'ABCDEFG',
            'taskid'    => 'ABCDEFG',
            'taskstatus' => 1,
        ];
        $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": 1581496800,
            "rsptime": 1581496800
        },
        "msg": ""
    }
    

#### 返回参数说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| desc | string | 返回描述 |