Documentación API

Zip2Geo ofrece una forma simple y rápida de convertir códigos postales en coordenadas geográficas. Para usar la API, envíe una solicitud GET al siguiente endpoint:

GET https://zip2geo.dev/api/lookup

Parámetros de consulta requeridos

• country – El código de país ISO 3166-1 alpha-2 (p. ej. DE, US, FR)
• postal_code – El código postal que desea buscar

Autenticación

Puede autenticarse usando uno de los siguientes métodos:

• Mediante encabezado HTTP: Authorization: Bearer YOUR_API_KEY
• O como parámetro de consulta: ?key=YOUR_API_KEY

Solicitud de ejemplo

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://zip2geo.dev/api/lookup?country=DE&postal_code=10115"

Respuesta de ejemplo

[
  {
    "postal_code": "10435",
    "country": "DE",
    "latitude": 52.5378,
    "longitude": 13.4112,
    "name": "Berlin",
    "state": "Berlin"
  }
]

Manejo de errores

• Clave API inválida
  Devuelve HTTP 401 Unauthorized::

  { "error": "Invalid API Key" }

• Host no permitido
  Devuelve HTTP 403 Forbidden::

  { "error": "Host not allowed" }

• No se encontraron resultados
  Devuelve HTTP 404 Not Found con un array vacío::

  []

Países soportados

A continuación se muestra una lista de todos los códigos de país ISO 3166-1 alpha-2 actualmente soportados por la API Zip2Geo:

Eso es todo. Sin complicaciones de registro, sin complejidad innecesaria — solo búsqueda de código postal a geo, bien hecho.