Menu

Documentation

Recherche d'états par leur ville

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

HTTP GET

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

Retourne l’état qui contient cette ville.

Quelques exemples de structure

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

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

Informations pertinentes

Notez qu’il existe de nombreuses villes portant le même nom.

Il existe 3 types d’opérations :

  • BASIC : Les champs id, state_name, lang sont renvoyés. Chaque état coûtera 1 jeton

  • NORMAL : Le champ state_cities est renvoyé [Tous les ID et noms des villes de l’état]. Chaque ville coûtera 1 jeton

  • ADVANCED : Le champ state_zip_codes est renvoyé [Tous les codes postaux de la ville]. Chaque code postal coûtera 1 jeton

Paramètres de requête

ParamètreTypeDescription
apikeyobligatoire, jetonClé d’authentification du compte
cityobligatoire, chaîneNom de la ville située dans l’état
limitTokenoptionnel, nombre1000 (par défaut). Nombre maximal de jetons que vous souhaitez dépenser dans cette requête
typeoptionnel, chaînebasic (par défaut), normal, advanced
langoptionnel, langueen (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,
              ...
          ]
        }
      ]