生成群邀请信息

获取可用于生成群二维码的内容。客户端把 payload 编码为二维码，扫码后用 token 预览或加入。

POST /app/sdk/groups/invite-qr

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

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

请求参数

JSON Body

参数	类型	必填	说明
group_id	string	是	公开群 ID，1–32 位字母、数字、点、下划线或连字符。

请求示例

curl 'https://example.com/app/sdk/groups/invite-qr' \
  -H "Authorization: Bearer $POPOIM_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"group_id":"6284173029"}'

使用说明

• 需开放群二维码功能，且当前账号具有分享群权限。
• 邀请凭据本身没有固定到期时间，但群被停用、解散，或分享者已不具备有效成员身份时，邀请可能失效。

返回参数

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

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

data 字段

字段	类型	说明
token	string	服务器签发的群邀请凭据，原样保存，不自行拼接。
payload	string	二维码内容，格式为 popoim://group-invite?token=...。
invite_group	InviteGroup	供加入前预览的群信息。
membership_status	string	active 已是成员、pending 入群申请待审批、not_member 尚未入群。
join_mode	string	direct 可直接入群；approval 需要群主或管理员审批。
can_join	boolean	当前是否可以提交加入操作；已是成员或已有待审批申请时为 false。

返回示例

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

{
  "code": 0,
  "msg": "ok",
  "data": {
    "token": "<群邀请接口返回的 token>",
    "payload": "popoim://group-invite?token=<群邀请接口返回的 token>",
    "invite_group": {
      "conversation_id": "group_6284173029",
      "group_id": "6284173029",
      "name": "秋日海岸出游",
      "avatar": "https://example.com/uploads/avatars/group/6284173029/1792301400.webp",
      "member_count": 2
    },
    "membership_status": "active",
    "join_mode": "direct",
    "can_join": false
  }
}

返回对象字段

数组中的每个对象使用同一套字段。点击名称跳到说明：

邀请中可见的群信息

邀请中可见的群信息（InviteGroup）

字段	类型	说明
conversation_id	string	群会话 ID。
group_id	string	公开群 ID。
name	string	群名称。
avatar	string	群头像地址。
member_count	integer	群成员人数。

错误处理

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

返回群与成员接口列表 · HTTP 请求约定