新建工单 - 微伴助手OpenAPI

错误码	说明
22302	handler_id非法，对应员工不存在
22303	cc_list内的id:“LiMei”非法，对应员工不存在
22304	staff_id非法，对应员工不存在
22309	relation_id非法，对象不存在
22310	component_id非法，对应组件不存在或与对应工单模板不匹配
22311	component_type为select，checked，radio或selectMultiple时，必须填写values
22312	component_type为input或textarea时，必须填写value
22313	sort排序值已存在需重新填写
22315	component_id: 120 必填
22316	values的值非法，不在选项中
22317	component中value和values必填其一

请求参数

Query 参数

access_token

string

调用接口凭证

必需

默认值:

Body 参数application/json

template_id

integer

模板id

必需

title

string

工单标题

必需

content

object

工单描述

必需

text

string

可选

备注文字，限制长度600字符符

pic

array[string]

图片链接列表

可选

relation_type

integer

必需

1-关联到客户，2-关联到客户群

relation_id

string

必需

关联到客户/客户群的id

handler_id

string

处理人

必需

msg_list

array[string]

聊天记录

可选

cc_list

array[string]

抄送人id列表

可选

staff_id

string

创建员工

必需

component_records

array [object {5}]

可选

添加的自定义表单组件列表

sort

integer

顺序

必需

title

string

组件标题

必需

value

string

可选

如果组件为input或textarea则值填在value里

values

array[string]

可选

如果组件类型不是input则将值填在values里

component_id

string

组件id

必需

示例

{
  "template_id": 0,
  "title": "string",
  "content": {
    "text": "string",
    "pic": [
      "string"
    ]
  },
  "relation_type": 0,
  "relation_id": "string",
  "handler_id": "string",
  "msg_list": [
    "string"
  ],
  "cc_list": [
    "string"
  ],
  "staff_id": "string",
  "component_records": [
    {
      "sort": 0,
      "title": "string",
      "value": "string",
      "values": [
        "string"
      ],
      "component_id": "string"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

order_no

string

新创建的工单号

必需

示例

成功示例异常示例（22309）relation_id不合法异常示例（22302）handler_id非法，对应员工不存在

{
  "errcode": 0,
  "errmsg": "ok",
  "order_no": "1145141919"
}

🟢200正常返回