智简魔方文档

POST 转内部工单

接口概览

项目内容
文档类型后台接口
请求方式POST
接口地址/DIR_ADMIN/v1/ticket/convert
所属业务插件
来源模块/系统工单
认证方式Bearer Token(管理员令牌)

完整请求

请求

bash
正在加载示例…

失败请求

bash
正在加载示例…

接口说明

转内部工单

请求体

json
正在加载示例…

请求参数

名称位置类型必选说明
bodybodyobject是—
ticket_idbodyinteger(int32)否工单 ID(转内部工单时需要传此参数)
titlebodystring是内部工单标题
ticket_type_idbodyinteger(int32)是内部工单类型 ID(调admin/v1/ticket/internal/type获取列表)
prioritybodystring是紧急程度:medium一般,high紧急
client_idbodyinteger(int32)否关联用户
admin_role_idbodyinteger(int32)是指定部门
admin_idbodyinteger(int32)否管理员 ID
host_idsbody[integer]否关联产品 ID,数组(/admin/v1/host?client_id= 获取所选客户的产品列表,取产品 ID)
contentbodystring否问题描述
attachmentbody[string]否附件,数组(后台调admin/v1/upload(前台调console/v1/upload)上传文件,取返回值save_name)

成功响应

json
正在加载示例…

失败响应 400:请求参数或业务校验失败

json
正在加载示例…

失败响应 401:未认证或登录已失效

json
正在加载示例…

失败响应 403:无权执行当前操作

json
正在加载示例…

失败响应 404:接口或业务资源不存在

json
正在加载示例…

失败响应 500:服务器内部错误

json
正在加载示例…

响应状态

状态码状态码含义说明数据模型
200OK成功响应内联对象
400Bad Request请求参数或业务校验失败内联对象
401Unauthorized未认证或登录已失效内联对象
403Forbidden无权执行当前操作内联对象
404Not Found接口或业务资源不存在内联对象
500Internal Server Error服务器内部错误内联对象

响应参数

失败状态码 400、401、403、404、500 共用以下结构:

名称类型必选约束说明
statusinteger(int32)是—错误状态码
msgstring是—错误提示