目录

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": "总价"
        }
     ]
    },
    ...
  ]
}