目录

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