← API 参考
群组GET

列出入群申请

列出开启入群审批的群的待审批申请。group_id 走 query 参数。上游的实时推送不保证可靠，请以轮询本端点为准。

https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests

请求头

X-Api-Key
string必填

工作区 API Key，工作区由该请求头解析得到。

路径参数

account_id
string必填

用于该 groups 路由的标识符。

查询参数

group_id
string必填

要操作的群——即 List groups 返回的 id。因渠道侧 id 可能含 @ 或 : 等字符，故保留在 query 字符串中。

请求体

该接口无需 JSON 请求体。

响应体

id
string

入群申请标识；批准或拒绝时作为 member_ids 传入。

phone
string

申请人的手机号，渠道暴露时返回。

lid
string

渠道提供时返回的申请人 LID。

requested_at
string

发起入群申请的 RFC3339 时间戳。

format: date-time

group_id
string

入群申请所属的群组。

响应

200
200 OK

请求成功，响应体示例如上。

400
请求错误

请求体、路径或参数不合法。

401
未授权

X-Api-Key 请求头缺失或无效。

404
未找到

未找到请求的渠道资源。

409
冲突

当前操作与已有的渠道账号或资源冲突。

500
服务端错误

服务端遇到了未预期的错误。

501
渠道未实现

所选渠道尚未实现该操作。

502
上游网关错误

渠道适配器或上游渠道未能完成该操作。

请求

curl -X GET https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests?group_id=group_example \
  -H "X-Api-Key: <YOUR_API_KEY>"

响应

{
  "data": {
    "group_id": "group_example",
    "items": [
      {
        "id": "member_example",
        "phone": "8613912345678",
        "requested_at": "2026-06-08T12:34:56Z"
      }
    ]
  }
}