Documentation

Rechercher des états selon leur pays

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

HTTP GET

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

Retourne l'état qui possède ce pays.

Quelques exemples de la structure

Pays : États-Unis, État : Colorado, Ville : Denver

Pays : Espagne, État : Communauté Valencienne, Ville : Valence

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
country requis, string Nom du pays dont on souhaite les états
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,
          ...
      ]
    }
  ]