← Tham chiếu API
Nhà cung cấpGET

Liệt kê khu vực của nhà cung cấp

Trả về các khu vực mà provider đã được triển khai. supported cho biết provider có chạy trong khu vực hay không; allocatable cho biết các tài khoản mới hiện có thể được bind vào đó hay không.

https://api.unifyport.ai/v1/providers/{provider}/regions

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

provider
stringbắt buộc

Định danh dùng cho route providers.

enum: telegram, whatsapp, line, twitter, zalo, tiktok, whatsapp_protocol, x, x_client, twitter_client

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

provider
string

Provider được trả về thông tin khả dụng theo khu vực.

enum: telegram, whatsapp, line, twitter, zalo, tiktok, whatsapp_protocol

regions[]
object[]

Danh sách khu vực; mỗi mục có cờ supported và allocatable.

region
string

Định danh khu vực triển khai provider.

supported
boolean

Provider có hoạt động trong khu vực này hay không.

allocatable
boolean

Hiện có thể cấp phát tài khoản mới trong khu vực này hay không.

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ệ.

500
Internal Server Error

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

Yêu cầu

curl -X GET https://api.unifyport.ai/v1/providers/{provider}/regions \
  -H "X-Api-Key: <YOUR_API_KEY>"

Phản hồi

{
  "data": {
    "provider": "telegram",
    "regions": [
      {
        "region": "global",
        "supported": true,
        "allocatable": true
      }
    ]
  }
}