这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
帮我吧文档:数据接口:工单:工单 [2019/01/15 15:10] admin [JSON示例] |
帮我吧文档:数据接口:工单:工单 [2024/04/15 13:54] (当前版本) 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 | ||