CRM扩展
数据接口
- 开发向导
- 单点登录
- 工单
- 客服
- 客户
- 服务记录
- 表单
- 知识库
- 标签
- 账号
侧边栏
帮我吧文档:数据接口:工单:工单字段
JSON格式
| 名称 | 类型 | 注释 |
|---|---|---|
| id | int | 字段id，系统自动分配 |
| url | varchar | 字段的资源url |
| name | varchar | 字段名字 |
| key | varchar | 字段的唯一标识 |
| system | tinyint | 是否为系统字段，取值为：1-系统字段，0-自定义字段，默认为0 |
| type | int | 字段类型，取值为：1-下拉列表，2-单行文本，3-多行文本，4-正整数，5-小数，6-复选框，7-正则表达式，8-日期(格式为：2018-02-03)，11-表单，12-附件，13-评星，14-高级复选框，15-商品表，16-满意度评价表，17-电话类型的文本，20-资产表 |
| isRequired | tinyint | 是否必选，取值为：1-非必选，0-必选 |
| isReadonly | tinyint | 是否只读，取值为：1-只读，0-可编辑 |
| readonly_range | int | 只读范围，只有isReadonly取值为1时，该参数才生效。取值为：1-所有客服，2-客服分组，3-客服，4-当前用户。 |
| readonly_support | varchar | 当只读范围是某个客服时，该参数是客服id；当只读范围是某个客服分组时，该参数是客服分组id。 |
| custom_field_options | array | 下拉列表的选项，如果字段类型是下拉列表，该字段会有值。 |
| custom_field_table | array | 表单的列，如果字段类型是表单或商品表单，该字段会有值。 |
JSON示例
{
"id": 1,
"url": "https://www.bangwo8.com/api/v1/tickets/ticket_fields/1.json",
"name": "产品类型",
"key": "field_10",
"system": "0",
"type": "1",
"isRequired": "0",
"isReadonly": "0",
"readonly_range": "1",
"readonly_support": "231",
"custom_field_options": [//key为下拉选项的ID
{
"key": "231",
"value": "在线客服模块"
},
{
"key": "232",
"value": "呼叫中心模块"
},
{
"key": "233",
"value": "工单模块"
}
]
"table_columns": [//key为字段的唯一标识
{
"key": "pinming",
"value": "品名"
},
{
"key": "xinghao",
"value": "型号"
},
{
"key": "danjia",
"value": "单价"
},
{
"key": "shuliang",
"value": "数量"
},
{
"key": "zongjia",
"value": "总价"
}
]
}
查询工单自定义字段列表
GET /api/v1/tickets/ticket_fields.json
调用者权限
所有客服
调用示例
curl https://www.bangwo8.com/api/v1/tickets/ticket_fields.json -u {account}:{password}
返回值示例
Status: 200 OK
{
"ticket_fields":[
{
"id": 1,
"name": "产品类型",
"key": "field_10",
"system": "0",
"type": "1",
"isRequired": "0",
"isReadonly": "0",
"readonly_range": "1",
"readonly_supportgroup": "231",
"custom_field_options": [
{
"key": "231",
"value": "在线客服模块"
},
{
"key": "232",
"value": "呼叫中心模块"
},
{
"key": "233",
"value": "工单模块"
}
]
},
{
"id": 21,
"name": "商品明细表",
"key": "field_8",
"type": "15",
"isRequired": "",
"isReadonly": "",
"readonly_range": "",
"readonly_supportgroup": "",
"custom_field_options": [
],
"custom_field_table": [
{
"key": "pinming",
"value": "品名"
},
{
"key": "xinghao",
"value": "型号"
},
{
"key": "danjia",
"value": "单价"
},
{
"key": "shuliang",
"value": "数量"
},
{
"key": "zongjia",
"value": "总价"
}
]
},
...
]
}
查询工单字段列表（包含系统字段）
GET /api/v1/tickets/ticket_fields2.json
调用者权限
所有客服
调用示例
curl https://www.bangwo8.com/api/v1/tickets/ticket_fields2.json -u {account}:{password}
返回值示例
Status: 200 OK
{
"ticket_fields":[
{
"id": 1,
"name": "产品类型",
"key": "field_10",
"system": "0",
"type": "1",
"isRequired": "0",
"isReadonly": "0",
"readonly_range": "1",
"readonly_supportgroup": "231",
"custom_field_options": [
{
"key": "231",
"value": "在线客服模块"
},
{
"key": "232",
"value": "呼叫中心模块"
},
{
"key": "233",
"value": "工单模块"
}
]
},
{
"id": 21,
"name": "商品明细表",
"key": "field_8",
"type": "15",
"isRequired": "",
"isReadonly": "",
"readonly_range": "",
"readonly_supportgroup": "",
"custom_field_options": [
],
"custom_field_table": [
{
"key": "pinming",
"value": "品名"
},
{
"key": "xinghao",
"value": "型号"
},
{
"key": "danjia",
"value": "单价"
},
{
"key": "shuliang",
"value": "数量"
},
{
"key": "zongjia",
"value": "总价"
}
]
},
...
]
}
