← 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 路由嘅 ID。

請求內容

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
  }
}