foodie-server/specs/012-im-user-integration/contracts/open-im-account.md

Contract: 开通 IM 账号接口（平台对外）

方向: APP → 平台后端（入站接口） 用途: APP 在用户注册完成后（或首聊前）调用，为当前登录用户开通/获取 IM 账号凭证

请求

POST /infouser/user/im/open
Header: token: <登录token>

• 鉴权：通过 token 请求头解析当前 userId（复用 JwtUtil.getusid），不接受 body 传 userId（防越权）。
• 请求体：无（或空 JSON）。
• 适用对象：所有已登录用户类型（普通0/商家1/骑手2/夜市3）。

响应

成功（首次开通 或 幂等返回）

{
  "code": 200,
  "msg": "成功",
  "data": {
    "apiKey": "f7a49f9745114462a3333e5698aac9ae",
    "imUserId": "2069305587785445400"
  }
}

字段	类型	说明
data.apiKey	String	IM API 密钥
data.imUserId	String	IM 用户ID（字符串，规避前端 Long 精度丢失）

失败

场景	返回
未登录 / token 失效	错误（未登录提示），不开通
IM 平台不可用 / 超时 / 返回失败	错误（IM 开通失败，可重试），不写库

失败沿用项目全局异常 / AjaxResult.error(...) 约定。

行为契约

1. 幂等：当前用户已有 imApiKey → 直接返回现有凭证，不重复调用 IM 平台。
2. 成对写入：仅当 IM 返回 apiKey 与 userId 均有效时才同时写 im_api_key、im_user_id。
3. 不阻塞注册：本接口独立于注册流程；其失败不影响用户已注册状态。
4. 不接收 userId 参数：用户身份仅来自 token。