IM 开放平台 · 第三方接入

标准接入流程（5 步）

应用信息

字段	说明
appId	平台审核通过后发放的唯一应用标识
appName	应用名称
callbackUrl	OAuth 回调地址（HTTPS）
appType	应用类型
scope	申请的授权范围（最小授权）
status	PENDING / APPROVED / SUSPENDED

授权流程

OAuth 2.0 Authorization Code + PKCE，两层授权：

时序

1. 1第三方 App→IM
   GET /oauth/authorize?appId&scope&redirect_uri&code_challenge&code_challenge_method=S256
2. 2IM→用户
   展示授权页，用户确认
3. 3用户→IM
   用户确认，重定向 redirect_uri?code=...
4. 4第三方 App→IM
   POST /oauth/token（code + PKCE verifier）
5. 5IM→第三方 App
   返回 access_token / refresh_token / expires_in
6. 6第三方 App→IM
   GET /oauth/userinfo（Bearer token）

H5 内嵌 WebView 授权（原生桥 · 微信小程序模型）

第三方业务以 H5 页面内嵌在 IM App WebView 中运行时（本地生活 / KTV / 酒店 / 打车等小程序），通过容器注入的原生桥完成「IM 用户 → 第三方用户」授权登录，对齐微信小程序模型：wx.login() ↔ GVBridge.login()，code2Session ↔ /oauth/token + /api/v1/identity/oauth/im/callback。

时序

1. 1IM App（容器）→WebView
   注入 window.GVBridge.login({ appId, scope, redirectUri })
2. 2第三方 H5→IM App
   GVBridge.login()（App 原生用自身 JWT 调 /oauth/authorize 拿 code）
3. 3IM App→第三方 H5
   返回 { code, code_verifier, redirect_uri }
4. 4第三方 H5→第三方后端
   POST /api/v1/identity/oauth/im/callback（code + verifier + app_id）→ SaaS accessToken + accountId
5. 5第三方 H5→第三方后端
   GET /auth/contexts + POST /auth/context/select → X-Tenant-Context

关键点

标准接口清单

方法与路径	说明
POST /open/applications	应用注册申请
GET /open/applications/{appId}	应用信息查询（平台审核）
PUT /open/applications/{appId}	应用信息/scope 管理
GET /oauth/authorize	用户授权页
GET /oauth/consent	用户同意页（短期 request_id）
POST /oauth/token	code 换 token + userinfo
GET /oauth/userinfo	授权范围内用户资料
POST /oauth/revoke	撤销单个 token
POST /internal/admin/open-applications/{appId}/revoke	平台撤销应用授权（内部管理）

scope 说明（最小授权）

scope	说明
profile.basic	昵称 / 头像
profile.phone	手机号（脱敏）
notify	站内信 / 推送（预留 Reserved）

用户同步

安全规范

服务板块接入（小程序服务项）

打车、外卖、电商、本地生活等外部服务，若只需在 C 端「服务板块」展示入口并跳转（无需 OAuth 账号授权），走更轻量的「服务项（小程序）」接入。

C 端入口链路

服务项字段

字段	说明
typeId	所属服务类型 id
name	服务项名称（如「打车」）
link	跳转地址：小程序路径 / H5 URL / 自定义 scheme
introduction	服务介绍（选填）
icon	服务图标（媒体 objectId，选填）
status	发布状态：1=已发布（C 端可见）/ 0=停用
isTop	是否置顶
sortOrder	排序值

C 端公开读接口

打车接入示例

验收清单