开发者

GET/v3/get_document_countries

列出可供注册的国家

查找当前号码注册目录中提供的国家 ISO 代码和名称。

本页
  1. 选择注册国家
  2. 如果未列出某个国家
  3. 请求
  4. 响应
  5. 错误
  6. 可用性与附带影响

选择注册国家

在请求号码类型或注册要求之前,请从此响应中复制国家 ISO 代码。请使用号码服务所在的国家,不要自动采用客户的国籍所属国家或地址所在国家。

如果未列出某个国家

未列出某个国家,并不能证明该国不要求提供任何文件,也不能证明 MultiTEL 无法提供该国的号码。请将注册选项的选择与号码查找分开处理;如果所需国家不可选,请联系支持团队。

请求

请通过 HTTPS 使用已启用的 API 账户凭据。支持基本身份验证和已启用的 API 账户的持有者令牌;账户限制仍然适用。

使用 GET 请求,并将任何文档中列明的参数放在 URL 路径中。

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_countries"

响应

除了 HTTP 状态,还要检查 JSON 正文中的 status.code。response 是包含大写 iso 和 name 字符串的数组,按名称排序。此注册目录不同于号码库存查询,也不同于地址所用的通用国家列表。它并不保证已返回所有国家或上游结果的每一个可用页面。

此处仅示意响应结构,并非实时账户数据或当前报价。

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "iso": "US",
      "name": "United States"
    }
  ]
}

错误

  • 500: Unable to load available registration countries:注册国家查询未提供数据。请稍后重试;不要将其视为成功返回的空目录。

可用性与附带影响

  • 此目录或要求查询不会创建身份、上传证明材料、注册号码或下单。
  • 成功获取目录响应并不表示您的文件已获批准,也不表示所选号码已确认可以激活。