1. 工单字段
帮我吧API接口文档v1
  • 接口地图
  • 一、快速入门
    • 帮我吧数据接口 - 开发向导
    • 1.1 获取 Token
      POST
  • 二、核心业务实体
    • 2.1 客户与联系人
      • 联系人管理
        • 获取联系人列表
        • 获取多个联系人详情
        • 批量联系人详情
        • 搜索联系人
        • 创建联系人
        • 修改联系人
        • 删除联系人
        • 批量删除联系人
      • 客户分组
        • 获取分组列表
        • 获取分组详情
        • 批量分组详情
        • 创建分组
        • 修改分组
        • 获取分组用户
      • 联系人字段
        • 获取联系人字段列表
      • 公司管理
        • 获取公司列表
        • 获取公司详情
        • 批量公司详情
        • 创建公司
        • 修改公司
        • 删除公司
        • 批量删除公司
        • 搜索公司
      • 公司字段
        • 获取公司字段列表
        • 获取公司联系人
      • 远程 ID 管理
        • 获取远程ID信息
        • 修改远程ID备注
        • 远程ID绑定联系人
        • 解绑远程 ID
    • 2.2 工单
      • 工单管理
        • 获取工单列表
        • 获取工单详情
        • 批量工单详情
        • 搜索工单
        • 创建工单
        • 修改工单
        • 批量修改工单
        • 工单拆单
      • 工单回复
        • 获取工单回复列表
      • 工单附件
        • 上传工单附件
      • 工单字段
        • 获取工单自定义字段
          GET
        • 获取工单所有字段
          GET
        • 覆盖字段选项
          POST
        • 更新字段选项
          PUT
        • 删除字段选项
          DELETE
      • 工单模板
        • 获取模板列表
        • 批量工单模板
        • 获取模板详情
        • 获取模板字段
      • 工单查询器
        • 获取查询器列表
        • 获取查询器详情
        • 获取查询器的工单列表
        • 获取查询器的工单总数
        • 批量获取查询器工单数量
    • 2.3 服务记录
      • IM 服务记录
        • 获取 IM 聊天记录
        • 获取 IM 会话列表
        • 获取 IM 会话详情
        • 获取服务总结(IM)
      • CC 服务记录
        • 获取呼叫中心记录列表
        • 获取呼叫中心记录详情
        • 获取指定客服的通话记录列表
        • 获取服务总结(CC)
        • 录音解冻
      • 远程协助记录
        • 获取远程记录列表
        • 获取坐席远程记录
        • 获取远程记录的聊天记录
        • 获取服务总结(远程协助)
      • 服务总结
        • 获取业务模板列表
        • 获取业务模板详情
        • 获取业务记录列表
        • 获取业务记录详情
        • 修改业务记录
    • 2.4 知识库
      • 知识库条目
        • 获取知识库列表
        • 获取知识库详情
        • 获取多条知识库
        • 创建知识库
        • 修改知识库
        • 上传知识库附件
      • 知识库分类
        • 获取知识库分类列表
        • 新增知识库分类
        • 修改知识库分类
        • 删除知识库分类
      • 附件上传
        • 上传附件
  • 三、人员与组织
    • 3.1 客服管理
      • 获取客服列表
      • 获取客服详情
      • 搜索客服
      • 获取多个客服信息
      • 创建客服
      • 修改客服信息
      • 删除客服信息
      • 恢复删除的客服
      • 客服授权
      • 查看客服状态
      • 修改客服状态
      • 获取客服签到列表
      • 创建客服签到
      • 获取客服排班列表
      • 新增客服排班
      • 更新客服排班
      • 删除客服排班
    • 3.2 客服组管理
      • 获取客服组列表
      • 获取客服组详情
      • 获取客服组下的客服
      • 创建客服组
      • 修改客服组
      • 删除客服组
  • 四、系统配置
    • 4.1 表单管理
      • 获取表单列表
      • 获取表单详情
      • 创建表单
      • 修改表单
      • 删除表单
    • 4.2 表单字段
      • 查询指定表单的字段列表
      • 表单字段选项增加、更新
    • 4.3 资产表
      • 获取指定资产表的所有数据
      • 给指定资产表添加一行数据
      • 给指定资产表添加多行数据
      • 根据唯一值更新指定资产表一行数据
      • 更新指定资产表一行数据
      • 删除一行数据
      • 搜索资产表中的资产数据
    • 4.4 自定义字段配置
      • 查询联系人字段列表
      • 查询公司字段列表
      • 查询工单自定义字段列表
      • 查询工单字段列表(包含系统字段)
      • 下拉字段选项全量覆盖
      • 新增、修改字段选项内容
      • 删除字段选项内容
    • 4.5 客服分组管理
      • 获取客服分组列表
      • 获取客服分组详情
      • 创建客服分组
      • 修改客服分组
      • 删除客服分组
    • 4.6 工单查询器管理
      • 获取查询器列表
      • 获取查询器详情
      • 获取查询器的工单列表
      • 获取查询器的工单总数
      • 批量获取查询器工单数量
    • 4.7 工单模板管理
      • 获取模板列表
      • 批量工单模板
      • 获取模板详情
      • 获取模板字段
    • 4.8 客户分组管理
      • 获取分组列表
      • 获取分组详情
      • 批量分组详情
      • 创建分组
      • 修改分组
      • 获取分组用户
    • 4.9 短信接口
      • 获取模板列表
      • 发送短信
    • 4.10 服务商设置
      • 获取服务商账号到期时间
    • 4.11 外部扩展集成
      • 扩展系统配置文档
      • 扩展页接口文档
      • 适用客户
  • 五、呼叫中心
    • 5.1 获取客服话机状态
      • 获取客服话机状态
    • 5.2 接听模式切换
      • 切换接听模式
    • 5.3 SDK网页集成(CC)
      • 适用场景
      • 快速集成
      • 高级对接
  • 六、在线客服
    • 6.1 SDK网页集成(IM)
      • 适用场景
      • 快速集成
      • 高级对接
  • 七、公共接口
    • 7.1 获取 Token
      • 获取 OAuth2 Token
    • 7.2 标签接口
      • 获取标签列表
  1. 工单字段

获取工单所有字段

GET
https://www.bangwo8.com/api/v1/tickets/ticket_fields2.json
最后修改时间:2026-04-06 05:16:25
责任人:未设置

查询工单字段列表(含系统字段)#

请求参数#

无

请求地址#

GET /api/v1/tickets/ticket_fields2.json

调用示例#

返回参数#

名称类型注释
idint字段id,系统自动分配
urlvarchar字段的资源url
namevarchar字段名字
keyvarchar字段的唯一标识
systemtinyint是否为系统字段,取值为:1-系统字段,0-自定义字段,默认为0
typeint字段类型,取值为:1-下拉列表,2-单行文本,3-多行文本,4-正整数,5-小数,6-复选框,7-正则表达式,8-日期(格式为:2018-02-03),11-表单,12-附件,13-评星,14-高级复选框,15-商品表,16-满意度评价表,17-电话类型的文本,20-资产表
isRequiredtinyint是否必选,取值为:1-非必选,0-必选
isReadonlytinyint是否只读,取值为:1-只读,0-可编辑
readonly_rangeint只读范围,只有isReadonly取值为1时,该参数才生效。取值为:1-所有客服,2-客服分组,3-客服,4-当前用户。
readonly_supportvarchar当只读范围是某个客服时,该参数是客服id;当只读范围是某个客服分组时,该参数是客服分组id。
custom_field_optionsarray下拉列表的选项,如果字段类型是下拉列表,该字段会有值。
custom_field_tablearray表单的列,如果字段类型是表单或商品表单,该字段会有值。

返回示例#

[
    {
        "id": "8769479",
        "name": "新梯数据表",
        "key": "field_1",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769482",
        "name": "电梯日常使用状况检查表",
        "key": "field_2",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769485",
        "name": "保养汇总表",
        "key": "field_3",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769488",
        "name": "电/扶梯保养记录表",
        "key": "field_4",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769491",
        "name": "曳引与强制驱动电梯日常维修保养记录单",
        "key": "field_5",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769494",
        "name": "深圳市特种设备安装改造大修告知书",
        "key": "field_6",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769551",
        "name": "深圳市特种设备安装改造大修告知书-告知设备清单",
        "key": "field_7",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769554",
        "name": "中华人民共和国特种设备安装改造维修许可证",
        "key": "field_8",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769557",
        "name": "安装确认表",
        "key": "field_9",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769560",
        "name": "安装完成表",
        "key": "field_10",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769563",
        "name": "工人签字",
        "key": "field_11",
        "type": "23",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769569",
        "name": "主管签字",
        "key": "field_12",
        "type": "23",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769572",
        "name": "经理签字",
        "key": "field_13",
        "type": "23",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8769575",
        "name": "特种设备安全监察局签字",
        "key": "field_14",
        "type": "23",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "8781221",
        "name": "确认情况",
        "key": "field_15",
        "type": "1",
        "isRequired": "0",
        "isReadonly": "0",
        "custom_field_options": [
            {
                "key": "1197569",
                "value": "安装局确认"
            },
            {
                "key": "1197572",
                "value": "安装师傅确认"
            },
            {
                "key": "1197575",
                "value": "主管确认"
            },
            {
                "key": "1197578",
                "value": "经理确认"
            }
        ]
    },
    {
        "id": "9481577",
        "name": "开单日期",
        "key": "field_18",
        "type": "8",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "9481617",
        "name": "区域",
        "key": "field_19",
        "type": "2",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "9481685",
        "name": "胶水",
        "key": "field_22",
        "type": "2",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "9481693",
        "name": "印刷方式",
        "key": "field_24",
        "type": "1",
        "isRequired": "0",
        "isReadonly": "0",
        "custom_field_options": [
            {
                "key": "1328981",
                "value": "转轮uv"
            },
            {
                "key": "1328985",
                "value": "普通uv"
            }
        ]
    }
]

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://www.bangwo8.com/api/v1/tickets/ticket_fields2.json' \
--header 'Authorization: Basic <encoded-value>'

返回响应

🟢200成功
application/json
Body

示例
[
    {
        "id": "1",
        "type": "1",
        "key": "ticketType",
        "name": "工单类型",
        "custom_field_options": [
            {
                "1": "问题",
                "2": "事务",
                "3": "故障",
                "4": "任务"
            }
        ]
    },
    {
        "id": "1",
        "type": "1",
        "key": "priorityLevel",
        "name": "工单优先级",
        "optionInfos": [
            {
                "1": "低",
                "2": "正常",
                "3": "高",
                "4": "紧急"
            }
        ]
    },
    {
        "id": "1",
        "type": "1",
        "key": "ticketStatus",
        "name": "工单状态",
        "optionInfos": [
            {
                "1": "新建",
                "2": "已开启",
                "3": "待回应",
                "4": "已解决",
                "6": "已关闭"
            }
        ]
    },
    {
        "id": "1",
        "type": "1",
        "key": "ticketSource",
        "name": "工单来源",
        "optionInfos": [
            {
                "1": "远程",
                "2": "聊天",
                "3": "呼叫中心",
                "4": "留言",
                "5": "系统创建",
                "6": "其他",
                "7": "API",
                "8": "工单模板发布",
                "9": "邮件接入",
                "10": "其他服务商",
                "11": "工单工作台",
                "12": "手动导入",
                "13": "客户管理自动化任务",
                "14": "帮我吧APP",
                "15": "ERP"
            }
        ]
    },
    {
        "id": "1264029",
        "name": "文本",
        "key": "field_1",
        "type": "2",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "1486095",
        "name": "总结",
        "key": "servicesummary_default_field",
        "type": "3",
        "isRequired": "0",
        "isReadonly": "1",
        "readonly_range": "1"
    },
    {
        "id": "10692799",
        "name": "附件标题",
        "key": "field_3",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "10693525",
        "name": "测试附件文件",
        "key": "field_4",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "12290698",
        "name": "运行环境说明",
        "key": "field_6",
        "type": "6",
        "isRequired": "1",
        "isReadonly": "1",
        "readonly_range": "1"
    },
    {
        "id": "13841488",
        "name": "文本字段wxj",
        "key": "field_7",
        "type": "2",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "19870627",
        "name": "下拉字段wxj",
        "key": "field_8",
        "type": "1",
        "isRequired": "0",
        "isReadonly": "0",
        "custom_field_options": [
            {
                "key": "4699012",
                "value": "选项1"
            },
            {
                "key": "4699013",
                "value": "选项2"
            },
            {
                "key": "4699014",
                "value": "选项3"
            }
        ]
    },
    {
        "id": "21101278",
        "name": "附件",
        "key": "field_9",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "21101281",
        "name": "附件2",
        "key": "field_10",
        "type": "12",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "22706591",
        "name": "日期时间",
        "key": "field_11",
        "type": "26",
        "isRequired": "0",
        "isReadonly": "1",
        "readonly_range": "1"
    },
    {
        "id": "22706594",
        "name": "日期",
        "key": "field_12",
        "type": "8",
        "isRequired": "0",
        "isReadonly": "1",
        "readonly_range": "1"
    },
    {
        "id": "23492725",
        "name": "地理位置",
        "key": "field_13",
        "type": "19",
        "isRequired": "0",
        "isReadonly": "0"
    },
    {
        "id": "24843587",
        "name": "级联1",
        "key": "field_14",
        "type": "18",
        "isRequired": "0",
        "isReadonly": "0",
        "custom_field_options": [
            {
                "key": "1",
                "value": "北京市",
                "subset_value": [
                    {
                        "key": "26",
                        "value": "北京1",
                        "subset_value": [
                            {
                                "key": "28",
                                "value": "北京11"
                            },
                            {
                                "key": "29",
                                "value": "北京12"
                            }
                        ]
                    },
                    {
                        "key": "27",
                        "value": "北京2",
                        "subset_value": [
                            {
                                "key": "30",
                                "value": "北京21"
                 
修改于 2026-04-06 05:16:25
上一页
获取工单自定义字段
下一页
覆盖字段选项
Built with