← API 參考
群組GET

列出入群申請

列出已開入群審批嘅群組嘅待審批申請。group_id 行 query 參數。上游嘅即時推送唔保證可靠，請以輪詢呢個端點為準。

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

請求標頭

X-Api-Key
string必填

工作區 API Key，工作區會由呢個標頭解析得出嚟。

路徑參數

account_id
string必填

用嚟識別嗰條 groups 路由嘅 ID。

查詢參數

group_id
string必填

想操作嘅群組 —— 即係 List groups 回返嘅 id。因為渠道嘅 id 入面可能有 @ 或者 :，所以擺喺 query string 度。

請求內容

呢個介面唔需要 JSON 請求內容。

回應內容

id
string

加入請求識別碼；批准或者拒絕嗰陣攞佢做 member_ids 傳入。

phone
string

申請人嘅電話號碼，渠道有畀嘅話先會有。

lid
string

渠道有提供時回傳嘅申請人 LID。

requested_at
string

提出加入請求嗰陣嘅 RFC3339 時間戳。

format: date-time

group_id
string

呢啲加入請求所屬嘅群組。

回應

200
200 OK

請求成功，回應內容嘅例子如上。

400
請求錯誤

請求內容、路徑或者參數無效。

401
未授權

X-Api-Key 請求標頭缺少或者無效。

404
搵唔到資源

搵唔到請求嘅渠道資源。

409
衝突

目前操作同現有嘅渠道帳號或者資源衝突。

500
伺服器錯誤

服務遇到咗未預期嘅錯誤。

501
渠道未實作

所選渠道未實作呢個操作。

502
上游閘道錯誤

渠道轉接器或者上游渠道未能完成呢個操作。

請求

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