- 接口地图
- 一、快速入门
- 二、核心业务实体
- 2.1 客户与联系人
- 2.2 工单
- 2.3 服务记录
- 2.4 知识库
- 三、人员与组织
- 四、系统配置
- 4.1 表单管理
- 4.2 表单字段
- 4.3 资产表
- 4.4 自定义字段配置
- 列表
- 创建
- 创建-单行文本 (type=2)
- 创建-多行文本 (type=3)
- 创建-正整数 (type=4)
- 创建-小数 (type=5)
- 创建-复选框 (type=6)
- 创建-正则表达式 (type=7)
- 创建-日期 (type=8)
- 创建-文件上传 (type=12)
- 创建-下拉列表 (type=1)
- 创建-下拉列表-带外部映射ID
- 创建-高级复选框 (type=14)
- 创建-级联 (type=18)
- 创建-评分 (type=13)
- 创建-文本电话 (type=17)
- 创建-地理位置 (type=19)
- 创建-表格文本 (type=21)
- 创建-签名 (type=23)
- 创建-支付 (type=24)
- 创建-计算字段 (type=25)
- 创建-日期时间 (type=26)
- 更新
- 删除
- 查询联系人字段列表
- 查询公司字段列表
- 查询工单自定义字段列表
- 查询工单字段列表（包含系统字段）
- 下拉字段选项全量覆盖
- 新增、修改字段选项内容
- 删除字段选项内容
- 4.5 客服分组管理
- 4.6 工单查询器管理
- 4.7 工单模板管理
- 4.8 客户分组管理
- 4.9 短信接口
- 4.10 服务商设置
- 4.11 外部扩展集成
- 五、呼叫中心
- 六、在线客服
- 七、公共接口
- 八、远程工具
- 九、AI助手
获取客服排班列表
GET
https://www.bangwo8.com/api/v1/schedules.json
最后修改时间：2026-04-06 05:16:25
责任人：未设置
获取客服排班列表接口文档#
接口说明#
获取客服排班列表#
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 | 排班对象 |
| 名称 | 类型 | 注释 |
|---|---|---|
sid | int | 客服ID |
date | datetime | 日期 |
schedules | array | 排班列表（二维数组） |
| 名称 | 类型 | 注释 |
|---|---|---|
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"
}
]
]
}
}
}请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password示例：
Authorization: Basic *****************Query 参数
请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://www.bangwo8.com/api/v1/schedules.json?startDT=2023-12-01&endDT=2023-12-31' \
--header 'Authorization: Basic <encoded-value>'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"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"
}
]
}
]
}
}修改于 2026-04-06 05:16:25