WuKongIM Docs

提交消息

编辑此页报告文档问题

接口边界

  • 调用方:仅限受信业务后端
  • 作用域:消息由受信后端提交;可选 X-WK-Trace-ID 必须是 32 位十六进制文本,否则服务端忽略并生成新值。
  • 成功判定:HTTP 200 仍必须检查 reason;只有成功 Reason Code 才表示消息被接受。
POST/message/send

接受完整兼容 parser,包括旧别名、瞬时标志与请求级订阅者;HTTP 200 时仍需检查 reason。

标头参数

X-WK-Trace-ID?string

可选的 32 位十六进制追踪 ID;格式不符时服务端忽略该值并生成新 ID。

匹配^[0-9a-fA-F]{32}$

请求主体

application/json

受信后端要提交的消息及其投递选项。

TypeScript 定义

在 TypeScript 中使用 request body 类型。

完整的兼容消息发送参数。

响应主体

application/json

application/json

application/json

application/json

application/json

application/json

{  "message_id": 0,  "message_seq": 0,  "reason": 1,  "client_msg_no": "string"}