← API 参考
群组POST

批准 / 拒绝入群申请

批量批准或拒绝入群申请。action 取 approve 或 reject；member_ids 取「列出入群申请」返回的一个或多个 id。

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

请求头

X-Api-Key
string必填

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

Content-Type
string必填

发送 JSON 请求体时使用 application/json。

路径参数

account_id
string必填

用于该 groups 路由的标识符。

请求体

group_id
string必填

目标群组标识。

action
string必填

渠道支持的成员或审批动作。

enum: approve, reject

member_ids[]
string[]必填

要处理的入群申请成员标识列表。

minItems: 1

响应体

ok
boolean

操作成功时始终为 true；失败时返回非 2xx 状态码而非该字段。

响应

200
200 OK

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

400
请求错误

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

401
未授权

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

404
未找到

未找到请求的渠道资源。

409
冲突

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

500
服务端错误

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

501
渠道未实现

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

502
上游网关错误

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

请求

curl -X POST https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests/update \
  -H "X-Api-Key: <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "group_id": "group_example",
  "action": "approve",
  "member_ids": ["member_example", "member_other"]
}'

响应

{
  "data": {
    "ok": true
  }
}