====JSON格式====
^名称 ^类型 ^注释 ^
|id |int |自定义字段id,系统自动分配 |
|url |varchar |自定义字段的资源url |
|name |varchar |自定义字段名字|
|key |varchar |自定义字段的唯一标识|
|type |int |自定义字段类型,取值为:1-下拉列表,2-单行文本,3-多行文本,4-正整数,5-小数,6-复选框,7-正则表达式,8-日期(格式为:2018-02-03),11-表单,12-附件,13-评星,14-高级复选框,15-商品表,16-满意度评价表,17-电话类型的文本|
|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",
"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",
"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": "总价"
}
]
},
...
]
}