举报用户

提交针对用户的举报，可附上本人可见的聊天记录作为证据。

POST /app/sdk/reports/user

调用方： SDK 客户端　·　认证： IM Token

请求头：Authorization: Bearer <IM Token>。先通过宿主后端获取 Token，再交给 SDK 使用。

请求参数

JSON Body

参数	类型	必填	说明
user_id	string	是	目标用户的外部 user_id，1–64 字符，不含控制字符。
request_id	string	是	本次操作的去重 ID，1–64 位字母、数字、点、下划线、冒号或连字符。同一次操作重试时保持不变。
reason_code	integer	是	举报原因：1 骚扰、2 不适当内容、3 诈骗、4 侵权、5 冒充他人、6 其他违规、7 聊天内容违规、8 资料违规。
description	string | null	否	补充说明，最长 1000 字符；不传或 null 时为空字符串。
conversation_id	string | null	否	附消息证据时提供所属会话，最长 256 字符。
message_ids	string[]	否	消息证据 ID，默认 []，最多 20 项，不重复，每项为最多 19 位的正十进制字符串。

请求示例

curl 'https://example.com/app/sdk/reports/user' \
  -H "Authorization: Bearer $POPOIM_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"user_id":"linzhou","request_id":"outing-20261018-01","reason_code":8,"description":"请协助核实这条活动通知的来源。","conversation_id":"friend_bGluemhvdQ","message_ids":["8601"]}'

使用说明

• 相同 request_id 重试时，目标、原因、说明和证据都要保持一致。服务器会检查当前账号能否访问被举报对象和消息证据。

返回参数

成功响应的最外层字段如下。下面所有业务字段都位于 data 中。

字段	类型	说明
code	integer	0 表示成功；非 0 时查看 msg，不把 data 当成功结果使用。
msg	string	成功通常为 ok，失败时为错误说明。
data	object	本次请求的业务结果，字段见下表。

data 字段

字段	类型	说明
request_id	string	本次举报的去重 ID。
status	string	pending 待处理、reviewed 已审核、closed 已关闭。
created_at	integer	举报创建时间，Unix 毫秒时间戳。
created	boolean	是否新建举报；相同请求重试时为 false。

返回示例

示例展示字段结构；ID、时间和资料仅作说明，请使用实际回包。

{
  "code": 0,
  "msg": "ok",
  "data": {
    "request_id": "report-20261018-01",
    "status": "pending",
    "created_at": 1792301400000,
    "created": true
  }
}

错误处理

先检查 HTTP 状态，再检查 code。业务失败可能仍为 HTTP 200；非 0 的 code 都不能当成功。完整错误码见请求约定。

返回举报与诊断接口列表 · HTTP 请求约定