← API 参考
渠道方GET

列出渠道区域

返回某个 provider 已开通的区域。supported 表示 provider 是否在该区域可用；allocatable 表示当前是否可在该区域绑定新账号。

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

请求头

X-Api-Key
string必填

工作区 API Key，工作区由该请求头解析得到。

路径参数

provider
string必填

用于该 providers 路由的标识符。

请求体

该接口无需 JSON 请求体。

响应

200
200 OK

请求成功，响应体示例如上。

400
请求错误

请求体、路径或参数不合法。

401
未授权

X-Api-Key 请求头缺失或无效。

409
冲突

当前操作与已有的渠道账号或资源冲突。

500
服务端错误

服务端遇到了未预期的错误。

请求

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

响应

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