开发者

GET/v3/countries

列出目录中的国家(旧版格式)

此旧版端点以 {code, data} 响应体返回与 GET /v3/other/{isocode} 所使用的特殊号码目录关联的可见国家。它不检查库存。请使用 GET /v3/getcountries 查找有号码库存的国家。

本页
  1. 请求
  2. 响应
  3. 错误
  4. 可用性与副作用

此旧版端点返回 {"code", "data"} 响应体,而非标准的 status/response 封装结构。它列出与特殊号码目录关联的可见国家,不检查库存。

对于新集成:

  • 使用 GET /v3/getcountries 查找有号码库存的国家。
  • 使用 GET /v3/other/{isocode} 查看某个国家实际提供哪些特殊号码类型。即使某个国家在此处列出,在该端点查询时仍可能返回空目录。

请求

必需:HTTP Basic 身份验证或 Bearer 令牌(请参阅“身份验证和 API 响应”)。身份验证失败时,会在执行查询之前以标准封装结构返回 HTTP 401。

GET 请求,不带参数,也不带请求体。

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/countries'

响应

不含标准封装结构的旧版响应体:{code: 200, data: [...]}。其中没有 status 对象,也没有 msg 或 results 字段。data 列出国家,不保证排列顺序。字段包括:countrycode(不带 '+' 的国家呼叫代码)、name、description(值与 name 相同)、isocode、latitude 和 longitude。其中没有 is_mobile、sms_coverage 或 next_function 字段。国家在可见且与特殊号码目录关联时才会被列出。由于不检查库存,列出的国家目前可能没有任何可用号码。如果没有国家符合条件,data 为 null。

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

错误

  • 401: 缺少身份验证或身份验证失败。以 HTTP status 401 在标准 status/response 封装结构中返回,而非使用旧版响应体。

可用性与副作用

  • 仅执行查询。不会预留、订购或更改任何内容。