帮我吧文档:数据接口:工单:工单
差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
|
帮我吧文档:数据接口:工单:工单 [2020/02/26 17:31] admin |
帮我吧文档:数据接口:工单:工单 [2024/05/17 17:50] (当前版本) admin [调用示例] |
||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | ===== 工单接口 ===== | ||
| - | 此接口仅供客服使用。 | + | ===== 工单列表 ===== |
| - | ==== JSON格式 | + | ==== 请求参数 |
| - | ^ 名称 | + | ^名称 |
| - | | ticketId | + | |created_start |
| - | | url | string | + | |created_end |
| - | | subject | + | |updated_start |
| - | | descript | + | |updated_end |
| - | | ticketSource | int | 否 | + | |created_order |
| - | | ticketType | + | |updated_order |
| - | | priorityLevel | int | 否 | + | |status_order |
| - | | ticketStatus| int | + | |page |否 |number |
| - | | custUserId| int | 否 | 否 | 联系人ID | | + | |per_page |
| - | | agentId| int | + | |
| - | | createrId| int | 否 | 否 | 创建人ID | | + | // |
| - | | servicerUserId| int | 否 | 否 | 客服ID | | + | |
| - | | servicerGroupId| int | 否 | 否 | 客服组ID | | + | 分页：数据返回条数太多时，会自动分页，默认每页100条，可以在请求url里更改per_page参数的值来自定义每页返回的条数，建议不要超过100条，因为会影响接口返回速度。 当请求的数据个数超过per_page参数值时，可设置自增的page参数继续请求下一页数据。 |
| - | | ccUserIdList| string | + | |
| - | |ccGroupIdList| string |否 | 否 |抄送组ID列表| | + | ==== 请求地址 ==== |
| - | |ticketTemplateId| int | 否 | 否 | 工单模板ID。**一个工单有哪些字段取决于工单模板，所以设置工单的字段值，必须传工单模板ID**| | + | |
| - | | tagList| string| 否 | 否 | 工单标签列表| | + | |
| - | | createDT| date| 是| 否 | 创建时间| | + | |
| - | | updateDT| date| 是| 否 | 更新时间| | + | |
| - | | custom_fields| array| 否 | 否 | 工单自定义字段，不支持验证码、评星等特殊自定义字段| | + | |
| - | | tables| array| 否 | 否 | 表单类型的工单自定义字段，新建或修改工单时需用到该参数| | + | |
| - | ====JSON示例==== | ||
| < | < | ||
| - | { | + | GET http:// |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | }, | + | |
| - | { | + | |
| - | " | + | |
| - | " | + | |
| - | " | + | |
| - | } | + | |
| - | ], | + | |
| - | " | + | |
| - | | + | |
| - | " | + | |
| - | " | + | |
| - | {// | + | |
| - | " | + | |
| - | " | + | |
| - | ... | + | |
| - | }, | + | |
| - | {// | + | |
| - | " | + | |
| - | " | + | |
| - | ... | + | |
| - | } | + | |
| - | ... | + | |
| - | ] | + | |
| - | }, | + | |
| - | {// | + | |
| - | " | + | |
| - | " | + | |
| - | {// | + | |
| - | " | + | |
| - | " | + | |
| - | ... | + | |
| - | }, | + | |
| - | {// | + | |
| - | " | + | |
| - | " | + | |
| - | ... | + | |
| - | } | + | |
| - | ... | + | |
| - | ] | + | |
| - | } | + | |
| - | ... | + | |
| - | + | ||
| - | ] | + | |
| - | } | + | |
| </ | </ | ||
| - | ==== 工单列表 ==== | + | 也可以使用下面的接口 |
| < | < | ||
| - | GET / | + | / |
| + | GET http:// | ||
| + | / | ||
| + | GET http:// | ||
| </ | </ | ||
| - | **查询参数** | + | ==== 调用者权限 ==== |
| - | ^ 名称 | + | |
| - | | created_start | + | |
| - | | created_end | + | |
| - | | updated_start | + | |
| - | | updated_end | + | |
| - | | created_order | + | |
| - | | updated_order | + | |
| - | | status_order | + | |
| - | | page | 否 | number | 页码，默认为 1 | | + | |
| - | | per_page | 否 | number | 每页大小，默认为 100 | | + | |
| - | // | + | < |
| + | 管理员 | ||
| + | </code> | ||
| + | ==== 调用示例 ==== | ||
| + | **（若看不懂，请先看一下**[[https:// | ||
| - | **调用者权限** | ||
| - | 管理员 | ||
| - | |||
| - | 也可以使用下面的接口 | ||
| < | < | ||
| - | / | + | curl -X GET -v -u {account}:{password} https:// |
| - | GET / | + | |
| - | / | + | |
| - | GET /api/v1/ | + | |
| </ | </ | ||
| + | ==== 返回参数 ==== | ||
| - | **调用示例** | + | ^名称 |
| - | < | + | |ticketId |
| - | curl https:// | + | |custUserId |
| - | -v -u {account}: | + | |subject |
| - | </ | + | |descript |
| + | |servicerUserId | ||
| + | |ccUserIdList | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |tagList | ||
| + | |ticketStatus | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |solveDT | ||
| + | |waitDT | ||
| + | |openDT | ||
| + | |closeDT | ||
| + | |servicerGroupId | ||
| + | |createrId | ||
| + | |createrType | ||
| + | |agentId | ||
| + | |ticketSource | ||
| + | |ticketTemplateId | ||
| + | |ccGroupIdList | ||
| + | |customTemplateId | ||
| + | |rootTicket | ||
| + | |createrType | ||
| + | |currentNodeField | ||
| + | |currentNodeFieldValue | ||
| + | |nodeFieldIntoTime | ||
| + | |queryIDs | ||
| + | |custom_fields | ||
| + | |tables | ||
| + | |count | ||
| + | |next_page | ||
| + | |previous_page | ||
| + | |||
| + | ==== 返回值示例 ==== | ||
| - | **返回值示例** | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| - | |||
| { | { | ||
| - | | + | " |
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| - | " | + | " |
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| }, | }, | ||
| { | { | ||
| - | " | + | " |
| - | " | + | " |
| { | { | ||
| - | "cpdm":" | + | "field_1": "20109029", |
| - | "cpmc":" | + | " |
| - | "zjm":" | + | " |
| - | "ggxh":" | + | " |
| + | "rowId": "1" | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | "field_1": "20109029", | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | "rowId": "1" | ||
| }, | }, | ||
| { | { | ||
| - | "cpdm":" | + | "field_1": "20109015", |
| - | "cpmc":" | + | "field_2": "QDP1020B", |
| - | "zjm":" | + | "field_4": "台", |
| - | "ggxh":" | + | " |
| + | "rowId": "2" | ||
| } | } | ||
| ] | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| } | } | ||
| ] | ] | ||
| } | } | ||
| - | | + | ], |
| - | " | + | " |
| " | " | ||
| " | " | ||
| 行 195: | 行 259: | ||
| </ | </ | ||
| + | ===== 查看工单 ===== | ||
| + | |||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |||
| + | ==== 请求地址 ==== | ||
| - | ==== 查看工单 ==== | ||
| < | < | ||
| - | GET / | + | GET |
| </ | </ | ||
| - | ** | + | |
| - | 调用者权限** | + | ==== 调用者权限 |
| - | 管理员 | + | |
| - | + | < | |
| - | **调用示例** | + | |
| + | </ | ||
| + | |||
| + | ==== 调用示例 | ||
| + | |||
| + | **（若看不懂，请先看一下**[[https:// | ||
| < | < | ||
| - | curl https:// | + | curl https:// |
| -v -u {account}: | -v -u {account}: | ||
| </ | </ | ||
| - | **返回值示例** | + | |
| + | |||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |custUserId | ||
| + | |subject | ||
| + | |descript | ||
| + | |servicerUserId | ||
| + | |ccUserIdList | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |tagList | ||
| + | |ticketStatus | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |solveDT | ||
| + | |waitDT | ||
| + | |openDT | ||
| + | |closeDT | ||
| + | |servicerGroupId | ||
| + | |createrId | ||
| + | |agentId | ||
| + | |ticketSource | ||
| + | |ticketTemplateId | ||
| + | |ccGroupIdList | ||
| + | |customTemplateId | ||
| + | |createrType | ||
| + | |currentNodeField | ||
| + | |currentNodeFieldValue | ||
| + | |nodeFieldIntoTime | ||
| + | |queryIDs | ||
| + | |rootTicket | ||
| + | |custom_fields | ||
| + | |||
| + | |||
| + | |||
| + | ==== 返回值示例 | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| - | |||
| { | { | ||
| - | " | + | |
| - | " | + | |
| - | " | + | " |
| - | ... | + | " |
| - | } | + | |
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| } | } | ||
| </ | </ | ||
| - | ==== 查看工单（旧） ==== | + | ===== 查看工单（旧） ===== |
| + | |||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |||
| + | ==== 请求地址 ==== | ||
| < | < | ||
| - | GET / | + | GET / |
| </ | </ | ||
| - | // | ||
| - | \\ | + | // |
| + | |||
| + | ==== 调用者权限 ==== | ||
| - | ** | ||
| - | 调用者权限** | ||
| - | 管理员 | ||
| - | | ||
| - | **调用示例** | ||
| < | < | ||
| - | curl https:// | + | 管理员 |
| - | -v -u {account}: | + | |
| </ | </ | ||
| - | **返回值示例** | + | ==== 调用示例 |
| + | |||
| + | **（若看不懂，请先看一下**[[https:// | ||
| < | < | ||
| - | Status: 200 OK | + | curl https:// |
| + | -v -u {account}: | ||
| + | </ | ||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |custUserId | ||
| + | |subject | ||
| + | |descript | ||
| + | |servicerUserId | ||
| + | |ccUserIdList | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |tagList | ||
| + | |ticketStatus | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |solveDT | ||
| + | |waitDT | ||
| + | |openDT | ||
| + | |closeDT | ||
| + | |servicerGroupId | ||
| + | |createrId | ||
| + | |agentId | ||
| + | |ticketSource | ||
| + | |ticketTemplateId | ||
| + | |ccGroupIdList | ||
| + | |customTemplateId | ||
| + | |createrType | ||
| + | |currentNodeField | ||
| + | |currentNodeFieldValue | ||
| + | |nodeFieldIntoTime | ||
| + | |queryIDs | ||
| + | |custom_fields | ||
| + | |||
| + | |||
| + | |||
| + | ==== 返回值示例 ==== | ||
| + | |||
| + | < | ||
| + | Status: 200 OK | ||
| { | { | ||
| - | " | + | |
| - | { | + | " |
| - | " | + | " |
| - | " | + | |
| - | ... | + | " |
| - | } | + | " |
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| ] | ] | ||
| + | } | ||
| } | } | ||
| </ | </ | ||
| + | ===== 查看多个工单 ===== | ||
| + | ==== 请求参数 ==== | ||
| + | ^名称 | ||
| + | |ticketId | ||
| + | ==== 请求地址 ==== | ||
| - | ==== 查看多个工单 ==== | ||
| < | < | ||
| - | GET / | + | GET / |
| </ | </ | ||
| - | // | + | |
| - | ** | + | // |
| - | 调用者权限** | + | |
| - | 管理员 | + | ==== 调用者权限 |
| - | **调用示例** | + | |
| + | < | ||
| + | | ||
| + | </ | ||
| + | |||
| + | ==== 调用示例 | ||
| + | |||
| + | **（若看不懂，请先看一下**[[https:// | ||
| < | < | ||
| - | curl https:// | + | curl http:// |
| -v -u {account}: | -v -u {account}: | ||
| </ | </ | ||
| - | **返回值示例** | + | |
| + | |||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |custUserId | ||
| + | |subject | ||
| + | |descript | ||
| + | |servicerUserId | ||
| + | |ccUserIdList | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |tagList | ||
| + | |ticketStatus | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |solveDT | ||
| + | |waitDT | ||
| + | |openDT | ||
| + | |closeDT | ||
| + | |servicerGroupId | ||
| + | |createrId | ||
| + | |agentId | ||
| + | |ticketSource | ||
| + | |ticketTemplateId | ||
| + | |ccGroupIdList | ||
| + | |customTemplateId | ||
| + | |createrType | ||
| + | |currentNodeField | ||
| + | |currentNodeFieldValue | ||
| + | |nodeFieldIntoTime | ||
| + | |queryIDs | ||
| + | |custom_fields | ||
| + | |||
| + | ==== 返回值示例 | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| + | { | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | </ | ||
| + | ==== 没有权限返回示例 ==== | ||
| + | |||
| + | < | ||
| + | Status:403 Forbidden | ||
| { | { | ||
| - | | + | |
| - | { | + | "message": "No relevant permissions" |
| - | | + | |
| - | " | + | |
| - | ... | + | |
| - | | + | |
| - | { | + | |
| - | | + | |
| - | | + | |
| - | ... | + | |
| - | }, | + | |
| - | ... | + | |
| - | ] | + | |
| } | } | ||
| </ | </ | ||
| - | ==== 创建工单 ==== | + | ===== 创建工单 ===== |
| + | |||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |subject | ||
| + | |descript | ||
| + | |custUserId | ||
| + | |custUser | ||
| + | |createrId | ||
| + | |createrType | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |ticketTemplateId | ||
| + | |tagList | ||
| + | |lockKey | ||
| + | |lockValue | ||
| + | |custom_fields | ||
| + | |tables | ||
| + | |isAppraise | ||
| + | |||
| + | |||
| + | ==== 请求地址 ==== | ||
| < | < | ||
| POST / | POST / | ||
| </ | </ | ||
| - | **调用者权限** | + | ==== 调用者权限 |
| - | 管理员 | + | |
| - | **请求参数** | + | < |
| - | ^ 名称 | + | 管理员 |
| - | | subject | + | </ |
| - | | ticketReply | + | |
| - | | custUserId| int|否 | 联系人id，说明该工单是为该客户解决问题| | + | **//custUser参数说明//** |
| - | | custUser| object|否 | 联系人信息| | + | |
| - | | servicerUserId| int|否 | 受理客服id| | + | 目前支持的联系人信息有mobilephone、name、fixnumber、qq、email、companyid，如果要使用该参数，则mobilephone是必需的，其余是选填项。如果数据库里没有该联系人信息，则会自动创建。当传companyid时，是为了绑定这个公司和这个手机号为当前工单的客户信息，要确认该companyid的公司下已经绑定该手机号，如果未绑定： |
| - | | servicerGroupId| int|否 | 受理客服组id| | + | companyid存在于此服务商，创建工单失败 提示：The phone number is not correct； |
| - | | ccUserIdList| string|否 | 抄送客服id列表| | + | companyId存在于其他服务商 创建工单失败 提示：The phone number is not correct； |
| - | | ccGroupIdList| string|否 | 抄送客服组id列表| | + | companyid错误id，不存在的或者不是数字 |
| - | | ticketSource| int|否 | 工单来源：1--远程，2--聊天，3--呼叫中心，4--留言，5--系统创建，7--API，8--工单模板发布，9--邮件接入| | + | 当不传companyid时，则默认绑定该手机号绑定的第一家公司为当前工单的客户信息 |
| - | | ticketType| int|否 |工单类型：1--问题，2--事务，3--故障，4--任务| | + | |
| - | | priorityLevel| int|否 | 工单优先级：1--低，2--正常，3--高，4--紧急| | + | |
| - | | ticketStatus| int|否 | 工单状态：1--新建，2--已开启，3--待回应，4--已解决，5--自动关闭，6--手动关闭| | + | |
| - | | ticketTemplateId| int | 是 |工单模板id，创建工单需指明当前工单使用哪个工单模板| | + | |
| - | | tagList| int|否 | 工单标签列表，以逗号分隔| | + | |
| - | | custom_fields| array|否 | 工单自定义字段| | + | |
| - | // | ||
| - | 目前支持的联系人信息有mobilephone、name、fixnumber、qq、email，如果要使用该参数，则mobilephone是必需的，其余是选填项。如果数据库里没有该联系人信息，则会自动创建。 | ||
| < | < | ||
| " | " | ||
| 行 329: | 行 833: | ||
| " | " | ||
| " | " | ||
| + | " | ||
| } | } | ||
| </ | </ | ||
| - | // | + | |
| - | key是字段的唯一标识，可从“帮我吧后台-》工单自定义字段”查看；value是该字段的具体值。 | + | **// |
| + | |||
| + | key是字段的唯一标识，可从“帮我吧后台如下图中查看自定义字段的唯一标识；value是该字段的具体值。 | ||
| + | |||
| + | {{: | ||
| + | {{: | ||
| < | < | ||
| - | " | + | " |
| { | { | ||
| " | " | ||
| 行 346: | 行 857: | ||
| </ | </ | ||
| - | // | + | **// |
| - | 工单附件包含两种类型：自定义字段类型的附件和工单回复里的附件。无论是哪种类型的附件，都需要先调用[[:工单:工单回复|工单回复]]里的上传附件接口，调用成功后，系统会返回相应的附件token，然后将相应参数置位此token即可。 | + | |
| + | 工单附件包含两种类型：自定义字段类型的附件和工单回复里的附件。上传附件有两种方式: | ||
| + | \\ | ||
| + | 说明：传的附件会将原有的附件全量覆盖，请谨慎使用 | ||
| + | \\ | ||
| + | 方式一：直接将附件地址上传（该地址需要是https协议地址），附件名称fileName一定要有后缀，后缀与附件的格式是一样的。 | ||
| + | |||
| + | < | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | | ||
| + | }] | ||
| + | </ | ||
| + | |||
| + | 方式二：先调用工单附件里的上传附件接口，调用成功后，系统会返回相应的附件token，然后将返回的token配置到value对应值即可。 | ||
| < | < | ||
| / | / | ||
| " | " | ||
| - | { | + | |
| " | " | ||
| - | " | + | " |
| + | | ||
| } | } | ||
| ] | ] | ||
| + | </ | ||
| + | < | ||
| / | / | ||
| " | " | ||
| 行 365: | 行 902: | ||
| ] | ] | ||
| } | } | ||
| - | </ | + | </ |
| - | // | + | |
| - | 表单类型的字段与普通自定义字段传值方式不一样，不在“custom_fields”进行传值，而是在“tables”里传值，“tables”与“custom_fields”是并列关系。 | + | **//创建带普通表单类型的工单// |
| + | |||
| + | 表单类型的字段与普通自定义字段传值方式不一样，不在“custom_fields”进行传值，而是在“tables”里传值，“tables”与“custom_fields”是并列关系，在创建表单数据时返回数据中会有一个curId，最好把每行数据curId存储，以便后期在调用更新工单的表单数据时根据curId进行更新表单数据。 | ||
| < | < | ||
| " | " | ||
| 行 390: | 行 930: | ||
| </ | </ | ||
| + | **// | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | ], | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | **// | ||
| + | 选项内容传值： | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | ] | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </ | ||
| + | 通过外部扩展id传值： | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | ], | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </ | ||
| + | |||
| + | **// | ||
| \\ | \\ | ||
| - | **调用示例** | + | 普通复选框：0为置空，1为选中 |
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </ | ||
| + | |||
| + | 高级复选框：两种方式，传选项id，或者传外部扩展id | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | |||
| + | </ | ||
| + | |||
| + | ==== 调用示例 | ||
| + | |||
| + | **curl** | ||
| < | < | ||
| curl https:// | curl https:// | ||
| - | -d ' | + | -d '{ |
| - | -H " | + | " |
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | ' | ||
| + | -H " | ||
| + | | ||
| + | | ||
| </ | </ | ||
| - | **返回值示例** | + | java |
| + | // | ||
| + | |||
| + | <code java> | ||
| + | OkHttpClient client = new OkHttpClient().newBuilder() | ||
| + | .build(); | ||
| + | MediaType mediaType = MediaType.parse(" | ||
| + | RequestBody body = RequestBody.create(mediaType, | ||
| + | Request request = new Request.Builder() | ||
| + | .url(" | ||
| + | .method(" | ||
| + | .addHeader(" | ||
| + | .addHeader(" | ||
| + | .build(); | ||
| + | Response response = client.newCall(request).execute(); | ||
| + | </ | ||
| + | |||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |subject | ||
| + | |ticketReply | ||
| + | |custUserId | ||
| + | |custUser | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |ticketTemplateId | ||
| + | |createrId | ||
| + | |tagList | ||
| + | |lockValue | ||
| + | |lockValue | ||
| + | |custom_fields | ||
| + | |||
| + | ==== 返回值示例 | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| Location: https:// | Location: https:// | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | 添加幂等锁后触发锁机制返回参数 | ||
| + | < | ||
| { | { | ||
| - | | + | |
| - | "ticketId": | + | "message": |
| - | "subject": "产品咨询", | + | "data": { |
| - | ... | + | " |
| - | } | + | " |
| + | " | ||
| + | | ||
| } | } | ||
| </ | </ | ||
| - | ==== 更新工单 ==== | + | ===== 删除工单 ===== |
| + | ==== 请求地址 ==== | ||
| < | < | ||
| - | PUT / | + | DELETE |
| </ | </ | ||
| - | **调用者权限** | + | ==== 调用者权限 |
| - | 所有客服 | + | |
| - | + | ||
| - | **请求参数** | + | |
| - | ^ 名称 | + | |
| - | | ticketReply | + | |
| - | | servicerUserId| int|否 | 受理客服id| | + | |
| - | | servicerGroupId| int|否 | 受理客服组id| | + | |
| - | | ccUserIdList| int|否 | 抄送客服id列表，如果是抄送的客服分组，则传客服分组id，多个id之间以逗号分隔| | + | |
| - | | ticketSource| int|否 | 工单来源：1--远程，2--聊天，3--呼叫中心，4--留言，5--系统创建| | + | |
| - | | ticketType| int|否 |工单类型：1--问题，2--事务，3--故障，4--任务| | + | |
| - | | priorityLevel| int|否 | 工单优先级：1--低，2--正常，3--高，4--紧急| | + | |
| - | | ticketStatus| int|否 | 工单状态：1--新建，2--已开启，3--待回应，4--已解决，5--自动关闭，6--手动关闭| | + | |
| - | | ticketTemplateId | int | 否 | 工单模板| | + | |
| - | | tagList| int|否 | 工单标签列表，以逗号分隔| | + | |
| - | | custom_fields| array|否 | 工单自定义字段| | + | |
| - | **调用示例** | ||
| < | < | ||
| - | curl https:// | + | 管理员 |
| + | </ | ||
| + | |||
| + | ==== 调用示例 ==== | ||
| + | |||
| + | **（若看不懂，请先看一下**[[https:// | ||
| + | |||
| + | < | ||
| + | curl -v -u {account}: | ||
| + | -H " | ||
| + | -X DELETE | ||
| + | </ | ||
| + | |||
| + | ==== 返回参数 ==== | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===== 更新工单 ===== | ||
| + | |||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |subject | ||
| + | |descript | ||
| + | |ticketReply | ||
| + | |custUserId | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |ticketTemplateId | ||
| + | |tagList | ||
| + | |custom_fields | ||
| + | |tables | ||
| + | |isSubmit | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | ==== 请求地址 ==== | ||
| + | |||
| + | < | ||
| + | PUT / | ||
| + | </ | ||
| + | |||
| + | ==== 调用者权限 ==== | ||
| + | |||
| + | < | ||
| + | 所有客服 | ||
| + | </ | ||
| + | |||
| + | ==== 调用示例 ==== | ||
| + | 如需置空单行文本和下拉字段，请传“NULL”字符串 | ||
| + | |||
| + | curl | ||
| + | |||
| + | < | ||
| + | curl https:// | ||
| -H " | -H " | ||
| - | -d ' | + | -d '{ |
| + | " | ||
| + | "subject": | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | }, | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | ], | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| + | }' \ | ||
| -v -u {account}: | -v -u {account}: | ||
| </ | </ | ||
| - | **返回值示例** | + | java |
| + | |||
| + | <code java> | ||
| + | OkHttpClient client = new OkHttpClient().newBuilder() | ||
| + | .build(); | ||
| + | MediaType mediaType = MediaType.parse(" | ||
| + | RequestBody body = RequestBody.create(mediaType, | ||
| + | Request request = new Request.Builder() | ||
| + | .url(" | ||
| + | .method(" | ||
| + | .addHeader(" | ||
| + | .addHeader(" | ||
| + | .addHeader(" | ||
| + | .build(); | ||
| + | Response response = client.newCall(request).execute(); | ||
| + | </ | ||
| + | |||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |subject | ||
| + | |descript | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |custUserId | ||
| + | |agentId | ||
| + | |createrId | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketTemplateId | ||
| + | |tagList | ||
| + | |createDT |date |是 | ||
| + | |updateDT | ||
| + | |custom_fields | ||
| + | |||
| + | ==== 返回值示例 | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| - | |||
| { | { | ||
| - | | + | " |
| - | | + | " |
| - | | + | " |
| - | | + | " |
| - | ... | + | " |
| - | } | + | " |
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | }, | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | ] | ||
| + | } | ||
| } | } | ||
| </ | </ | ||
| - | ====更新多个工单==== | + | ===== 更新多个工单 ===== |
| + | |||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |subject | ||
| + | |ticketReply | ||
| + | |custUserId | ||
| + | |custUser | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |ticketTemplateId | ||
| + | |tagList | ||
| + | |custom_fields | ||
| + | |||
| + | ==== 请求地址 ==== | ||
| < | < | ||
| - | PUT / | + | PUT / |
| - | PUT / | + | |
| </ | </ | ||
| - | // | ||
| - | **调用者权限** | + | ==== 调用者权限 |
| - | 所有客服 | + | |
| - | **调用示例** \\ | ||
| - | // | ||
| < | < | ||
| - | PUT / | + | 所有客服 |
| </ | </ | ||
| + | |||
| + | ==== 调用示例 ==== | ||
| + | |||
| + | **（若看不懂，请先看一下**[[https:// | ||
| + | |||
| < | < | ||
| + | 对不同的工单进行相同的处理，调用下面的接口： | ||
| + | PUT / | ||
| { | { | ||
| " | " | ||
| 行 478: | 行 1534: | ||
| } | } | ||
| } | } | ||
| - | </ | + | 对不同的工单进行不同的处理，调用下面的接口： |
| - | + | ||
| - | //对不同的工单进行不同的处理，调用下面的接口：// | + | |
| - | < | + | |
| PUT / | PUT / | ||
| - | </ | ||
| - | < | ||
| { | { | ||
| " | " | ||
| - | { " | + | { " |
| - | { " | + | { " |
| ] | ] | ||
| } | } | ||
| </ | </ | ||
| - | **返回值示例** | + | |
| + | |||
| + | ==== 返回参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |subject | ||
| + | |descript | ||
| + | |ticketSource | ||
| + | |ticketType | ||
| + | |priorityLevel | ||
| + | |ticketStatus | ||
| + | |custUserId | ||
| + | |agentId | ||
| + | |createrId | ||
| + | |servicerUserId | ||
| + | |servicerGroupId | ||
| + | |ccUserIdList | ||
| + | |ccGroupIdList | ||
| + | |ticketTemplateId | ||
| + | |tagList | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |custom_fields | ||
| + | |||
| + | ==== 返回值示例 | ||
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| - | |||
| { | { | ||
| " | " | ||
| 行 513: | 行 1589: | ||
| </ | </ | ||
| - | ====搜索工单==== | + | ===== 搜索工单 ===== |
| + | |||
| + | ==== 请求地址 ==== | ||
| < | < | ||
| GET / | GET / | ||
| </ | </ | ||
| - | **调用者权限** | + | ==== 调用者权限 |
| - | 所有客服 | + | |
| - | + | ||
| - | **请求参数** | + | |
| - | ^名称 ^类型 ^必需的 ^注释 ^ | + | |
| - | |query |string |是 |搜索内容| | + | |
| - | |sort_by |string | 否 |按时间排序，目前支持：createDT-创建时间，updateDT-更新时间| | + | |
| - | |sort_order| string | 否 | 按升序还是降序返回，取值为：asc-升序，desc-降序，默认为降序| | + | |
| - | query参数说明 | + | < |
| - | ^搜索内容 ^返回结果 ^ | + | 所有客服 |
| - | |query=2444 | 模糊搜索，返回工单编号、工单标题或者联系人姓名包含该内容的工单| | + | </ |
| - | |query=ticketStatus: | + | |
| - | |query=field_1: | + | ==== 请求参数 ==== |
| - | |query=2444 createDT> | + | |
| - | |query=ticketStatus: | + | ^名称 |
| - | |query=ticketStatus: | + | |query |
| + | |sort_by | ||
| + | |sort_order | ||
| + | |||
| + | ==== query参数说明 | ||
| + | |||
| + | ^搜索内容 | ||
| + | |query=2444 | ||
| + | |query=ticketStatus: | ||
| + | |query=field_1: | ||
| + | |query=uId: | ||
| + | |query=2444 createDT> | ||
| + | |query=ticketStatus: | ||
| + | |query=ticketStatus: | ||
| + | |||
| + | |||
| + | ^时间相关字段 | ||
| + | |createDT | ||
| + | |updateDT | ||
| + | |waitDT | ||
| + | |solveDT | ||
| + | |openDT | ||
| + | |closeDT | ||
| + | |||
| + | // | ||
| + | |||
| + | // | ||
| + | |||
| + | // | ||
| + | |||
| + | // | ||
| + | |||
| + | < | ||
| + | createDT< | ||
| + | createDT> | ||
| + | createDT: | ||
| + | createDT< | ||
| + | createDT> | ||
| + | solveDT> | ||
| + | </ | ||
| + | |||
| + | ==== 调用示例 ==== | ||
| - | //说明： //\\ | + | **（若看不懂，请先看一下**[[https://doc.bangwo8.com/doku.php?id=%E5%B8%AE%E6%88%91%E5%90%A7%E6%96%87%E6%A1%A3: |
| - | //1、暂不支持搜索内容本身带有空格// | + | |
| - | // | + | |
| - | // | + | |
| - | createDT< | + | |
| - | createDT> | + | |
| - | createDT:2017-09-01 | + | |
| - | createDT< | + | |
| - | createDT> | + | |
| - | **调用示例** | ||
| < | < | ||
| curl " | curl " | ||
| 行 553: | 行 1657: | ||
| </ | </ | ||
| - | **返回值示例** | + | ==== 返回值示例 |
| < | < | ||
| Status: 200 OK | Status: 200 OK | ||
| - | |||
| { | { | ||
| " | " | ||
| 行 581: | 行 1685: | ||
| </ | </ | ||
| + | ===== 拆单 ===== | ||
| + | ==== 请求参数 ==== | ||
| + | |||
| + | ^名称 | ||
| + | |ticketId | ||
| + | |separatedCount | ||
| + | |||
| + | ==== 请求地址 ==== | ||
| + | < | ||
| + | POST / | ||
| + | </ | ||
| + | |||
| + | ==== 调用者权限 ==== | ||
| + | 管理员 | ||
| + | |||
| + | ==== 请求示例 ==== | ||
| + | < | ||
| + | curl https:// | ||
| + | </ | ||
| + | |||
| + | ==== 返回示例 ==== | ||
| + | ===返回成功=== | ||
| + | < | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | ===返回失败=== | ||
| + | < | ||
| + | Status: 403 Forbidden | ||
| + | { | ||
| + | " | ||
| + | " | ||
| + | } | ||
| + | </ | ||
| + | ===错误码说明=== | ||
| + | ^错误码 | ||
| + | |110041 | ||
| + | |110042 | ||
| + | |110043 | ||
| + | |110044 | ||
| + | |110045 | ||
| + | |110046 | ||
| + | |110047 | ||
