Documentation

Rechercher des états selon leur code postal

Country Data API fournit des informations détaillées sur +200 pays différents

HTTP GET

https://api.countrydataapi.com/v1/states/zipCode

Retourne une liste de tous les états selon leur code postal

Information pertinente

Gardez à l'esprit qu'il y a beaucoup d'états de différents pays qui ont des codes postaux identiques

Selon les champs demandés, il y aura 3 types de requêtes :

  • BASIQUE : Les champs id, state_name, lang sont retournés Chaque état coûtera 1 jeton

  • NORMAL : Le champ state_cities est retourné [Tous les ids et noms des villes de l'état] Chaque ville coûtera 1 jeton

  • AVANCÉ : Le champ state_zip_codes est retourné [Tous les codes postaux de la ville] Chaque code postal 1 jeton

Paramètres de Requête

Paramètre Type Description
apikey requis, token Clé d'authentification du compte
zipcode requis, string Code postal de l'état souhaité
limitToken optionnel, number 1000 (par défaut). Nombre maximum de jetons que vous voulez dépenser dans cette requête
fields optionnel, string id,lang,state_name (par défaut). Champs attendus dans la réponse
lang optionnel, lang en (par défaut). Langue attendue de la réponse

Exemple de réponse

[
    {
      "id": "8dd25479-067a-43b0-ac4a-8e7faf2bcafb",
      "state_name":"Takhar",
      "lang":"en",
      "state_cities":[
          {
            id: "8dd25476-067a-43b0-ac4b-8e7faf2bcbfb",
            "city_name":"City",
            ...
          }
      ],
      "state_zip_codes": [
          00000,
          000001,
          ...
      ]
    }
  ]