Documentation

Rechercher des états selon leur ville

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

HTTP GET

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

Retourne l'état qui possède cette ville.

Quelques exemples de la structure

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

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

Information pertinente

Gardez à l'esprit qu'il y a beaucoup de villes avec le même nom

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
city requis, string Nom de la ville qui se trouve dans l'état
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,
          ...
      ]
    }
  ]