创建工单草稿

为当前企业的指定正常坐席创建普通工单草稿。请求先经过 v2 签名、企业工单服务、坐席状态和工单权限校验；content 必须直接传可被工单创建组件恢复的 JSON Object，且 content.templateId 必填。成功时 data 仅返回 draftId。

请求参数

名称	类型	必填	描述
appKey	string	是	应用 AppKey
time	int64	是	请求时间戳（秒）
checksum	string	是	请求签名校验和
checksumAlgorithm	int32	否	签名算法：0 - 默认(SHA1)，1 - SHA256

请求体

名称	类型	必填	描述	示例值
staffId	int64	是	创建草稿的坐席 ID；必须是当前企业的正常坐席且具有工单权限	10001
connectionId	int64	是	关联会话 ID，必须为正整数	90001
businessType	int32	是	业务类型，固定为工单创建场景位置 12	12
content	object	是	可被工单创建组件恢复的表单内容，必须直接传 JSON Object，其中 templateId 必填
└templateId	int64	否
└title	string	否
└content	string	否
└attachments	object[]	否
└id	int64	否
└name	string	否
└size	int64	否
└url	string	否
└type	int32	否
└priority	int32	否
└group	int64	否
└person	int64	否
└follower	int64[]	否
└category	int64	否
└categoryPathName	string	否
└customFields	object[]	否
└id	int64	否
└value	object	否

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
data	int64	草稿 ID	123456

错误码

状态码	描述
8002	字段缺失、类型错误、取值越界、未知字段，或 content 不是 JSON Object
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法的单一 JSON Object，或包含重复字段
14100	staffId 不是当前企业的正常状态坐席
14500	草稿服务内部异常
16001	企业不存在或工单服务不可用
19254	staffId 对应坐席没有工单权限

postEndpoint

/openapi/v2/ticket/draft/create

curl -X POST "https://qiyukf.com/openapi/v2/ticket/draft/create?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{    "staffId": 10001,    "connectionId": 90001,    "businessType": 12,    "content": {}  }'

{
  "code": 200,
  "data": 123456
}

{
  "code": 8002,
  "message": "字段缺失、类型错误、取值越界、未知字段，或 content 不是 JSON Object"
}

{
  "code": 14001,
  "message": "AppKey 不存在"
}

{
  "code": 14002,
  "message": "checksum 校验失败"
}

{
  "code": 14003,
  "message": "time 缺失，或请求时间戳与服务器时间误差超过 10 分钟"
}

{
  "code": 14004,
  "message": "请求体不是合法的单一 JSON Object，或包含重复字段"
}

{
  "code": 14100,
  "message": "staffId 不是当前企业的正常状态坐席"
}

{
  "code": 14500,
  "message": "草稿服务内部异常"
}

{
  "code": 16001,
  "message": "企业不存在或工单服务不可用"
}

{
  "code": 19254,
  "message": "staffId 对应坐席没有工单权限"
}