帮我吧文档:数据接口:工单:工单模板

工单模板

通过工单模板来区分不同种类的工单,比如报销类模板、产品需求类模板,模板里面添加相应的自定义字段。


JSON格式

名称 类型 只读 必填 注释
tId string 工单模板ID,系统自动生成
url varchar 该工单模板的资源url
ticketTemplateName string 工单模板名称
ticketTemplateDescription string 工单模板的描述
visibleRange string 工单模板的可见范围:1-所有客服,2-客服分组,3-客服,4-当前用户,“当前用户”为配置时,登录后台的人,默认可见范围取值为1-所有客服
servicerGroupId string 客服分组ID,当“visibleRange”取值为“2-客服分组”时,该字段会有值
servicerId string 客服ID,当“visibleRange”取值为“3-客服”时,该字段会有值
isReleased string 是否发布:0-未发布,1-已发布。工单模板发布后,会自动生成URL地址,在该地址填写的内容会自动生成工单,工单默认选中当前模板
creatorId string 创建工单模板的客服ID
createDT string 创建时间,格式为:2018-06-04 10:26:40

JSON示例

{
     "tId": 1,
     "url": "https://www.bangwo8.com/api/v1/tickettemplates/1.json",
     "ticketTemplateName": "报修模板",
     "ticketTemplateDescription": "供微信用户提交报修申请",
     "visibleRange": 3,
     "servicerGroupId": 22,
     "servicerId": 213,
     "isReleased": 0,
     "creatorId": 121,
     "createDT": "2017-05-04 14:08:22"
}

获取工单模板列表

GET /api/v1/tickettemplates.json

说明:默认按编码升序返回。

调用者权限

管理员

调用示例

curl https://www.bangwo8.com/api/v1/tickettemplates.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
	"tickettemplates": [
	   {
	      "tId": 1,
              "ticketTemplateName": "报修模板",
              "ticketTemplateDescription": "供微信用户提交报修申请",
              "visibleRange": 3,
              "servicerGroupId": 22,
              "servicerId": 213,
              "isReleased": 0,
              "creatorId": 121,
              "createDT": "2017-05-04 14:08:22"
	  },
	  {
	      "tId": 2,
              "ticketTemplateName": "报销模板",
              "ticketTemplateDescription": "供公司内部报修流程使用",
              "visibleRange": 3,
              "servicerGroupId": 22,
              "servicerId": 213,
              "isReleased": 0,
              "creatorId": 121,
              "createDT": "2017-05-04 14:28:12"
	  }
          ...
	],
        "count": "23"
}

查看指定工单模板信息

GET /api/v1/tickettemplates/{id}.json

调用者权限

管理员

调用示例

curl https://www.bangwo8.com/api/v1/tickettemplates/{id}.json \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
  "tickettemplate": {
       "tId": 1,
       "ticketTemplateName": "报修模板",
       "ticketTemplateDescription": "供微信用户提交报修申请",
       "visibleRange": 3,
       "servicerGroupId": 22,
       "servicerId": 213,
       "isReleased": 0,
       "creatorId": 121,
       "createDT": "2017-05-04 14:08:22"
  }
}

获取多个工单模板信息

GET /api/v1/tickettemplates/show_many.json?ids={ids}

调用者权限

管理员

调用示例

curl https://www.bangwo8.com/api/v1/tickettemplates/show_many.json?ids=1,2 \
  -v -u {account}:{password}

返回值示例

Status: 200 OK

{
    "tickettemplates": [
	   {
	      "tId": 1,
              "ticketTemplateName": "报修模板",
              "ticketTemplateDescription": "供微信用户提交报修申请",
              "visibleRange": 3,
              "servicerGroupId": 22,
              "servicerId": 213,
              "isReleased": 0,
              "creatorId": 121,
              "createDT": "2017-05-04 14:08:22"
	  },
	  {
	      "tId": 2,
              "ticketTemplateName": "报销模板",
              "ticketTemplateDescription": "供公司内部报修流程使用",
              "visibleRange": 3,
              "servicerGroupId": 22,
              "servicerId": 213,
              "isReleased": 0,
              "creatorId": 121,
              "createDT": "2017-05-04 14:28:12"
	  }
   ]
}

获取指定工单模板的自定义字段列表

GET /api/v1/tickettemplates/{id}/ticketfields.json

说明:自定义字段相关信息可参考JSON格式,默认按字段编码升序返回。

调用者权限

管理员

调用示例

curl https://www.bangwo8.com/api/v1/tickettemplates/1/ticketfields.json? \
  -v -u {account}:{password}

返回值示例
请参考查询工单自定义字段列表的返回值。

获取指定工单模板的所有字段列表(包含系统字段)

GET /api/v1/tickettemplates/{id}/ticketfields2.json

说明:自字段相关信息可参考JSON格式,默认按字段编码升序返回。

调用者权限

管理员

调用示例

curl https://www.bangwo8.com/api/v1/tickettemplates/1/ticketfields2.json? \
  -v -u {account}:{password}

返回值示例
请参考查询工单字段列表的返回值。


页面工具