我将为您把这个获取客服排班列表接口整理成 Markdown 格式。

获取客服排班列表接口文档

接口说明

获取客服排班列表，支持按日期范围查询。

获取客服排班列表

请求方法: GET

请求路径: /api/v1/schedules.json

调用者权限: 管理员

注意: 文档标题写的是 /api/v1/supports.json，但调用示例使用的是 /api/v1/schedules.json，请以实际调用示例为准。

请求参数

Query 参数

名称	必需的	类型	注释
`startDT`	否	datetime	开始日期（格式：2023-12-01）
`endDT`	否	datetime	结束日期（格式：2023-12-01）

调用示例

返回参数

名称	类型	注释
`code`	string	状态码（0表示成功）
`message`	string	状态信息
`data.duty`	object	排班对象

data.duty 参数：

名称	类型	注释
`sid`	int	客服ID
`date`	datetime	日期
`schedules`	array	排班列表（二维数组）

schedules 数组元素参数：

名称	类型	注释
`dutyId`	int	排班ID
`name`	varchar	排班名称（最大30个汉字）
`remark`	varchar	备注
`start_time`	datetime	开始时间（格式：20:00:00）
`end_time`	datetime	结束时间（格式：20:00:00）
`status`	int	排班状态

返回值示例

{
    "code": "0",
    "message": "ok",
    "data": {
        "duty": {
            "sid": "10591",
            "date": "2023-12-04",
            "schedules": [
                [
                    {
                        "dutyId": "10591_2023-12-04_656d4229600fa",
                        "name": "测试排班修改接口",
                        "remark": "测试修改",
                        "start_time": "12:01",
                        "end_time": "18:01",
                        "status": "1"
                    }
                ]
            ]
        }
    }
}

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "code": "0",
    "message": "ok",
    "data": {
        "718120": [
            {
                "_id": "13",
                "sid": "718120",
                "date": "2023-12-07",
                "schedules": [
                    {
                        "name": "Maxie.Carroll",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_6571961f3cef5",
                        "status": "1"
                    },
                    {
                        "name": "Wilmer71",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_6571962047e2e",
                        "status": "1"
                    },
                    {
                        "name": "Tito83",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-07_65719c3748233",
                        "status": "1"
                    }
                ]
            },
            {
                "_id": "16",
                "sid": "718120",
                "date": "2023-12-08",
                "schedules": [
                    {
                        "name": "Nils_Schumm73",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-08_65727cbab45a9",
                        "status": "1"
                    },
                    {
                        "name": "Jocelyn.Stroman95",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718120_2023-12-08_65727da69b26a",
                        "status": "1"
                    }
                ]
            }
        ],
        "718153": [
            {
                "_id": "14",
                "sid": "718153",
                "date": "2023-12-07",
                "schedules": [
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719765ce39b",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719765cea8d",
                        "status": "1"
                    },
                    {
                        "name": "Fidel4",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-07_65719765cf12a",
                        "status": "1"
                    },
                    {
                        "name": "Jean.Ernser",
                        "remark": "备注备注",
                        "start_time": "9:00",
                        "end_time": "10:00",
                        "dutyId": "718153_2023-12-07_65719c3318e08",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719c3748a32",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-07_65719c374917e",
                        "status": "1"
                    },
                    {
                        "name": "Trudie.Runolfsdottir12",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-07_65719c3749a67",
                        "status": "1"
                    }
                ]
            },
            {
                "_id": "15",
                "sid": "718153",
                "date": "2023-12-08",
                "schedules": [
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-08_65727da69f3c6",
                        "status": "1"
                    },
                    {
                        "name": "123",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "10:30",
                        "dutyId": "718153_2023-12-08_65727da6a152b",
                        "status": "1"
                    },
                    {
                        "name": "Angus_Willms",
                        "remark": "",
                        "start_time": "9:00",
                        "end_time": "11:30",
                        "dutyId": "718153_2023-12-08_65727da6a1d11",
                        "status": "1"
                    }
                ]
            }
        ]
    }
}

获取客服排班列表

获取客服排班列表接口文档#

接口说明#

获取客服排班列表#

请求参数#

Query 参数#

调用示例#

返回参数#

返回值示例#

请求参数

请求示例代码

返回响应

获取客服排班列表接口文档

接口说明

获取客服排班列表

请求参数

Query 参数

调用示例

返回参数

返回值示例