- 接口地图
- 一、快速入门
- 二、核心业务实体
- 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 外部扩展集成
- 五、呼叫中心
- 六、在线客服
- 七、公共接口
- 八、远程工具
获取联系人字段列表
GET
https://www.bangwo8.com/api/v1/users/user_fields.json
最后修改时间：2026-04-06 05:16:25
责任人：未设置
响应字段定义说明#
| 名称 | 类型 | 注释 |
|---|---|---|
| id | int | 字段id，字段在创建的时候由系统自动分配，系统字段默认为1 |
| name | varchar | 字段名字 |
| key | varchar | 字段的唯一标识 |
| type | int | 字段类型，取值为：1-下拉列表2-单行文本3-多行文本4-正整数5-小数6-复选框7-正则表达式8-日期(格式为：2018-02-03)12-附件14-高级复选框17-电话类型的文本18-级联 |
| system | tinyint | 是否为系统字段，取值为：1-系统字段0-自定义字段 |
| custom_field_options | array | 展示下拉列表选项或级联目录：• 如果字段类型是下拉列表，该字段会展示下拉列表的选项• 如果字段是级联字段，会展示级联的多级目录• 其他的字段类型展示为空 |
请求参数
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 'https://www.bangwo8.com/api/v1/users/user_fields.json' \
--header 'Authorization: Basic <encoded-value>'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"user_fields":[
{
"id":"1",
"name":"姓名",
"key":"name",
"type":"2",
"system":"1",
"custom_field_options":[
]
},
{
"id":"24295921",
"name":"authaccount",
"key":"authaccount",
"type":"2",
"system":"0",
"custom_field_options":[
]
},
{
"id":"24795771",
"name":"地区",
"key":"field_3",
"type":"18",
"system":"0",
"custom_field_options":[
{
"key":"1",
"value":"北京市",
"subset_value":[
{
"key":"26",
"value":"海淀",
"subset_value":[
{
"key":"28",
"value":"中关村"
},
{
"key":"29",
"value":"清华"
}
]
},
{
"key":"27",
"value":"朝阳"
}
]
},
{
"key":"6",
"value":"吉林省"
}
]
},
{
"id":"24799067",
"name":"联系人类型（下拉列表）",
"key":"field_4",
"type":"1",
"system":"0",
"custom_field_options":[
{
"key":"4457267",
"value":"VIP"
},
{
"key":"4457271",
"value":"普通联系人"
}
]
}
]
}修改于 2026-04-06 05:16:25