Listar los países del catálogo (formato heredado)

Este recurso heredado devuelve un cuerpo con la estructura {"code", "data"} en lugar de la estructura envolvente estándar status/response. Enumera los países visibles vinculados al catálogo de números especiales y no comprueba las existencias.

Para nuevas integraciones:

• Utilice GET /v3/getcountries para encontrar países con números disponibles.
• Utilice GET /v3/other/{isocode} para consultar qué tipos de números especiales se ofrecen realmente en un país. Aunque un país aparezca aquí, la consulta de su catálogo mediante ese recurso puede devolver un catálogo vacío.

Solicitud

Se requiere autenticación HTTP Basic o un token Bearer (consulte Autenticación y respuestas de la API). Si la autenticación falla, se devuelve HTTP 401 con la estructura envolvente estándar antes de realizar la consulta.

GET sin parámetros ni cuerpo.

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

Respuesta

Cuerpo heredado sin la estructura envolvente estándar: {code: 200, data: [...]}. No hay ningún objeto status ni campos msg o results. data enumera los países sin garantizar ningún orden. Campos: countrycode (prefijo telefónico sin '+'), name, description (con el mismo valor que name), isocode, latitude y longitude. No hay campos is_mobile, sms_coverage ni next_function. Un país se incluye cuando es visible y está vinculado al catálogo de números especiales. No se comprueban las existencias, por lo que un país incluido puede no tener números disponibles en ese momento. Si ningún país cumple las condiciones, data es null.

Estructura de respuesta ilustrativa; no contiene datos en tiempo real de una cuenta ni una cotización vigente.

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

Errores

• 401: Falta la autenticación o ha fallado. Se envía con HTTP status 401 en la estructura envolvente estándar status/response, no en el cuerpo heredado.

Disponibilidad y efectos secundarios

• Solo realiza una consulta. No reserva números, no realiza pedidos ni modifica nada.