推送 IM 工单卡片

按请求体中的 ticketId/title/content/corpMappingId/userMappingId 推送工单卡片消息。请求体字段均按可选处理；企业 appKey 不存在或请求体不是合法 JSON 时返回参数错误。

请求参数

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

请求体

名称	类型	必填	描述	示例值
ticketId	int64	否	工单 ID	123456
title	string	否	卡片标题	您有一个新的工单待处理
content	string	否	卡片内容	售后咨询：订单取消后未退款
corpMappingId	int64	否	企业映射 ID	1000
userMappingId	int64	否	用户映射 ID	556677

返回参数

名称	类型	描述	示例值
code	int32	状态码，200 表示成功	200
message	string	成功消息或业务结果	success

错误码

状态码	描述
8002	工单卡片推送失败，message 为具体业务错误信息
14001	AppKey 不存在
14002	checksum 校验失败
14003	time 缺失，或请求时间戳与服务器时间误差超过 10 分钟
14004	请求体不是合法 JSON；或按 appKey 查询企业为空
14500	服务内部异常；请求字段类型不符合要求或服务处理失败

postEndpoint

/openapi/worksheet/push/im/card

curl -X POST "https://qiyukf.com/openapi/worksheet/push/im/card?appKey=9f1d7c2b8a6e4d3c&time=1739347200&checksum=a1b2c3d4e5f607182930abcdefabcdef&checksumAlgorithm=0" \  -H "Content-Type: application/json" \  -d '{}'

{
  "code": 200,
  "message": "success"
}

{
  "code": 8002,
  "message": "工单卡片推送失败，message 为具体业务错误信息"
}

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

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

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

{
  "code": 14004,
  "message": "请求体不是合法 JSON；或按 appKey 查询企业为空"
}

{
  "code": 14500,
  "message": "服务内部异常；请求字段类型不符合要求或服务处理失败"
}