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

รายการคำขอเข้ากลุ่ม

แสดงคำขอเข้ากลุ่มที่รออนุมัติของกลุ่มที่เปิดการอนุมัติ ส่ง group_id เป็น query parameter การ push จากต้นทางไม่รับประกัน ให้ใช้การ poll เอนด์พอยต์นี้เป็นแหล่งที่เชื่อถือได้

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

ส่วนหัว

X-Api-Key
stringจำเป็น

API key ของพื้นที่ทำงาน ระบบจะระบุพื้นที่ทำงานจากส่วนหัวนี้

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

account_id
stringจำเป็น

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

พารามิเตอร์ Query

group_id
stringจำเป็น

กลุ่มที่ต้องการดำเนินการ — id ที่คืนจาก List groups เก็บไว้ใน query string เพราะ id ของผู้ให้บริการอาจมี @ หรือ :

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

จุดเชื่อมต่อนี้ไม่ต้องใช้เนื้อหา JSON

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

id
string

ตัวระบุคำขอเข้ากลุ่ม ส่งเป็น member_ids เมื่ออนุมัติหรือปฏิเสธ

phone
string

หมายเลขโทรศัพท์ของผู้ขอเข้า เมื่อผู้ให้บริการเปิดเผยค่านี้

lid
string

LID ของผู้ขอเข้ากลุ่มฝั่ง provider เมื่อมีค่า

requested_at
string

timestamp แบบ RFC3339 ของเวลาที่มีการขอเข้ากลุ่ม

format: date-time

group_id
string

กลุ่มที่คำขอเข้ากลุ่มสังกัดอยู่

การตอบกลับ

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 GET https://api.unifyport.ai/v1/accounts/{account_id}/groups/join-requests?group_id=group_example \
  -H "X-Api-Key: <YOUR_API_KEY>"

การตอบกลับ

{
  "data": {
    "group_id": "group_example",
    "items": [
      {
        "id": "member_example",
        "phone": "8613912345678",
        "requested_at": "2026-06-08T12:34:56Z"
      }
    ]
  }
}