用户信息托管

IM 服务端只保存一层很薄的用户资料（userId / name / avatarUrl / 状态位），没有独立的“用户中心”产品。是否把 IM 当作用户资料的权威源，是应用架构选择；本页给出两种托管模型、真实字段与写入路径、key 规范、同步 API 与限制。

资料模型​

两种托管模型​

推荐把「B」作为长期模型：IM 不提供目录同步连接器、LDAP/SCIM、组织架构或用户导入向导；同步逻辑必须在你自己的服务里实现。

同步时序（外部为主）​

1. 初始化：批量导入

   按 user.batch.get 校验已存在用户（上限 100/次），缺失的用 user.register 创建；user.register 对已存在 userId 是幂等的（更新 name/avatarUrl）。

2. 增量：业务库变更时推送

   改昵称/头像 → user.update；封禁/注销 → user.ban / user.deactivate。保留业务侧事件 ID 以便补偿。

3. 反向：客户端自助改昵称

   客户端只能改 name；如需同步回业务库，订阅 user.profile_changed 回调（载荷 {userId,changed:{name},timestamp}）后写回。

4. 审核回滚

   接内容审核时，审核拒绝可调 user.profile.moderation.sync（status=rejected + fields）清空 name/avatarUrl；清空后 name 回落为 userId。

5. 对账

   IM 用户没有 updatedAt，无法按时间戳做增量对账；用业务库版本号 + 定期全量比对（batch.get 100/次）兜底。

key 规范​

Open API​

注册 + 查询 + 批量（Node SDK）​

import { AppClient } from '@ni-paas-im/server-sdk';

const app = new AppClient({
  appKey: process.env.IM_APP_KEY,
  appSecret: process.env.IM_APP_SECRET,
  baseUrl: 'http://127.0.0.1:8080',
});

await app.registerUser({ userId: 'u_10086', name: '张三', avatarUrl: 'https://cdn.example.com/u/10086.png' });
await app.updateUser({ userId: 'u_10086', name: '张三（产品）' });

const { users, missing } = await app.batchGetUsers({ userIds: ['u_10086', 'u_99999'] });
console.log(users, missing); // u_99999 在 missing

审核回滚（curl，Open API 需签名）​

APP_KEY="demo"; APP_SECRET="YOUR_APP_SECRET"; BASE_URL="http://127.0.0.1:8080"
NONCE="$(openssl rand -hex 16)"; TIMESTAMP="$(date +%s%3N)"
SIGNATURE="$(printf '%s' "$APP_SECRET$NONCE$TIMESTAMP" | openssl sha1 | awk '{print $2}')"

curl -sS -X POST "$BASE_URL/docs/platform-chat-api/user/profile/moderation/sync" \
  -H "content-type: application/json" \
  -H "App-Key: $APP_KEY" -H "Nonce: $NONCE" \
  -H "Timestamp: $TIMESTAMP" -H "Signature: $SIGNATURE" \
  -d '{"userId":"u_10086","status":"rejected","reason":"nickname_violation","fields":{"name":"","avatarUrl":""}}'

客户端读取路径​

• Web SDK：client.getUserProfile(userId) → GET /api/apps/{appkey}/users/{userId}/profile，返回 {userId,name,createdAt}。
• Web SDK：client.updateMyUserProfile({name}) → POST /api/apps/{appkey}/users/{myUserId}/profile；只能改自己的 name，长度 1–64，成功后触发 user.profile_changed。
• 其它端（Android/Flutter/Electron/Native）按 sdk-imlib.json 的 getUserProfile / updateMyUserProfile 语义实现；头像不在客户端写入路径。

错误码与限制​

相关页面​

• 用户模块接口
• user.register / user.update / user.batch.get
• user.profile.clean / user.profile.moderation.sync
• 控制台 · 用户管理
• 内容审核指南