Documentation API

Zip2Geo offre un moyen simple et rapide de convertir les codes postaux en coordonnées géographiques. Pour utiliser l'API, envoyez une requête GET au point de terminaison suivant :

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

Paramètres de requête requis

• country – Le code pays ISO 3166-1 alpha-2 (par ex. DE, US, FR)
• postal_code – Le code postal que vous souhaitez rechercher

Authentification

Vous pouvez vous authentifier en utilisant l'une des méthodes suivantes :

• Via l'en-tête HTTP : Authorization: Bearer YOUR_API_KEY
• Ou en tant que paramètre de requête : ?key=YOUR_API_KEY

Exemple de requête

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

Exemple de réponse

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

Gestion des erreurs

• Clé API invalide
  Retourne HTTP 401 Unauthorized ::

  { "error": "Invalid API Key" }

• Hôte non autorisé
  Retourne HTTP 403 Forbidden ::

  { "error": "Host not allowed" }

• Aucun résultat trouvé
  Retourne HTTP 404 Not Found avec un tableau vide ::

  []

Pays pris en charge

Voici une liste de tous les codes pays ISO 3166-1 alpha-2 actuellement pris en charge par l'API Zip2Geo :

C'est tout. Pas de complications d'inscription, pas de complexité inutile — juste une recherche zip-to-geo, bien faite.