此旧版端点返回 {"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 封装结构中返回,而非使用旧版响应体。
可用性与副作用
- 仅执行查询。不会预留、订购或更改任何内容。