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