群組POST
設定入群審核模式
開啟或關閉群組的入群審核。enabled 為必填布林值——開啟後新成員必須先通過審核才能進群。
https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-approval-mode請求標頭
X-Api-Keystring必填
工作區 API Key,工作區會由此標頭解析得到。
Content-Typestring必填
傳送 JSON 請求內容時請使用 application/json。
路徑參數
account_idstring必填
用於該 groups 路由的識別字。
請求內容
group_idstring必填
目標群組識別字。
enabledboolean必填
是否要求管理員審批新成員。
回應內容
okboolean
操作成功時恆為 true;失敗時則改回傳非 2xx 狀態碼。
回應
200200 OK
請求成功,回應內容範例如上。
400請求錯誤
請求內容、路徑或參數無效。
401未授權
X-Api-Key 請求標頭缺少或無效。
404找不到資源
找不到請求的渠道資源。
409衝突
目前操作與既有的渠道帳號或資源衝突。
500伺服器錯誤
服務遇到了未預期的錯誤。
501渠道尚未實作
所選渠道尚未實作此操作。
502上游閘道錯誤
渠道轉接器或上游渠道未能完成此操作。
請求
curl -X POST https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-approval-mode \
-H "X-Api-Key: <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"group_id": "group_example",
"enabled": true
}'回應
{
"data": {
"ok": true
}
}