← เอกสารอ้างอิง API
GroupsPOST

อนุมัติ / ปฏิเสธคำขอเข้ากลุ่ม

อนุมัติหรือปฏิเสธคำขอเข้ากลุ่มแบบเป็นชุด 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จำเป็น

ใช้ application/json เมื่อต้องส่งเนื้อหาของคำขอเป็น JSON

พารามิเตอร์ใน path

account_id
stringจำเป็น

ตัวระบุที่ใช้ใน route ของ groups

เนื้อหาของคำขอ

group_id
stringจำเป็น

ตัวระบุกลุ่มเป้าหมาย

action
stringจำเป็น

การดำเนินการสมาชิกหรือการอนุมัติที่ provider รองรับ

enum: approve, reject

member_ids[]
string[]จำเป็น

ตัวระบุสมาชิกของคำขอเข้ากลุ่มที่จะดำเนินการ

minItems: 1

เนื้อหาการตอบกลับ

ok
boolean

เป็น true เสมอเมื่อการดำเนินการสำเร็จ ส่วนกรณีล้มเหลวจะคืนสถานะที่ไม่ใช่ 2xx แทน

การตอบกลับ

200
200 OK

คำขอสำเร็จ ดูตัวอย่างเนื้อหาตอบกลับด้านบน

400
Bad Request

เนื้อหาของคำขอ path หรือพารามิเตอร์ไม่ถูกต้อง

401
Unauthorized

ส่วนหัว X-Api-Key หายไปหรือไม่ถูกต้อง

404
Not Found

ไม่พบทรัพยากรของ provider ที่ร้องขอ

409
Conflict

การดำเนินการขัดแย้งกับบัญชีของผู้ให้บริการหรือทรัพยากรที่มีอยู่

500
Internal Server Error

บริการพบข้อผิดพลาดที่ไม่คาดคิด

501
Not Implemented

provider ที่เลือกยังไม่รองรับการดำเนินการนี้

502
Bad Gateway

อะแดปเตอร์หรือ upstream provider ไม่สามารถทำรายการให้เสร็จได้

คำขอ

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