GroupsGET

Danh sách yêu cầu vào nhóm

Liệt kê các yêu cầu đang chờ của nhóm bật duyệt thành viên. group_id truyền qua query parameter. Push từ thượng nguồn không được bảo đảm — hãy poll endpoint này làm nguồn tin cậy.

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

Tiêu đề

X-Api-Key

stringbắt buộc

API key của không gian làm việc. Không gian làm việc được xác định từ tiêu đề này.

Tham số đường dẫn

account_id

stringbắt buộc

Định danh dùng cho route groups.

Tham số truy vấn

group_id

stringbắt buộc

Nhóm cần thao tác — id được trả về bởi Liệt kê nhóm. Được giữ trong chuỗi truy vấn vì id của nhà cung cấp có thể chứa @ hoặc :.

Nội dung yêu cầu

Điểm cuối này không cần nội dung JSON.

Nội dung phản hồi

id

string

Định danh yêu cầu tham gia; truyền làm member_ids khi phê duyệt hoặc từ chối.

phone

string

Số điện thoại của người yêu cầu, khi nhà cung cấp công khai nó.

lid

string

LID của người yêu cầu phía provider, khi có.

requested_at

string

Dấu thời gian RFC3339 của thời điểm yêu cầu tham gia.

format: date-time

group_id

string

Nhóm mà các yêu cầu tham gia thuộc về.

Phản hồi

200

200 OK

Yêu cầu thành công. Xem ví dụ nội dung phản hồi.

400

Bad Request

Body, đường dẫn hoặc tham số yêu cầu không hợp lệ.

401

Unauthorized

Header X-Api-Key thiếu hoặc không hợp lệ.

404

Not Found

Không tìm thấy tài nguyên provider được yêu cầu.

409

Conflict

Thao tác đang yêu cầu xung đột với tài khoản hoặc tài nguyên nhà cung cấp đã có.

500

Internal Server Error

Dịch vụ gặp lỗi không mong muốn.

501

Not Implemented

Provider đã chọn chưa triển khai thao tác này.

502

Bad Gateway

Adapter hoặc upstream provider không thể hoàn tất thao tác.

Yêu cầu

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

Phản hồi

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