# 预测式外呼 - 预测外呼任务列表

#### 接口说明

**获取任务列表**

#### 请求参数

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| service | string | 是 | App.Sip\_Yccall.TaskList |
| token | string | 是 | 通过授权接口获取的token |
| createtime | datetime | 否 | 任务创建时间，格式：yyyy-mm-dd hh:mm:ss |
| endtime | datetime | 否 | 结束时间，格式：yyyy-mm-dd hh:mm:ss |
| taskid | string | 否 | 任务ID
| taskname| string | 否 | 任务名称
| status | string | 否 | 任务状态 0:未开始、1:进行中、2:暂停、3:结束
| tasktype| string | 否 | 接听类型 transfer:分机、groups:群组
| taskobject| string | 否 | 群组或坐席
| currentpage | int | 否 | 当前页
| itemsperpage | int | 否 | 每页显示
#### 接口请求示例（PHP）

    <?php
        $apiUrl = 'http://127.0.0.1:8080';
        $postFields = [
            'service'   => 'App.Sip_Yccall.TaskList',
            'token'     => 'ABCDEFG',
            'taskid'     => ''
        ];
        $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": 10,
            "task": [
                {
                    "taskid": "20250106150501420056", #任务id
                    "taskname": "20250106150501420056",  # 任务名称
                    "taskassign": "700000",  # 任务坐席
					"starttime": "2021-08-21 00:11:22",  # 启动时间
                    "taskscale": "1:2",  # 外呼比例
                    "nowscale": "", # 当前呼叫比例
                    "disnumber": "17328347742",  # 主叫号码
                    "status": 1025,  # 任务状态：1025=未开始，1026=进行中，1027=暂停，1028=已结束
                    "createtime": "2025-01-06 15:05:01",  # 创建时间
                    "total": 2,  # 任务总数
                    "called": 0,  # 已呼叫个数
                    "nocall": 2  # 未呼叫个数
                }
            ]
        },
            "reqtime": 1581496504,
            "rsptime": 1581496504
        },
        "msg": ""
    }
    

#### 返回参数说明

| 参数名 | 类型 | 说明 |
| --- | --- | --- |
| result | object | 返回结果 |