Documentation

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

HTTP GET

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

Retourne l’état associé à ce pays.

Quelques exemples de structure

Pays: USA, État: Colorado, Ville: Denver

Pays: Espagne, État: Comunidad Valenciana, Ville: Valencia

Il existe 3 types d’opérations :

• BASIC : Les champs id, state_name, lang sont retournés

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

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

Paramètres de requête

Paramètre	Type	Description
apikey	obligatoire, token	Clé d’authentification du compte
country	obligatoire, string	Nom du pays dont vous souhaitez les états
limitToken	facultatif, number	1000 (par défaut). Nombre maximum de jetons que vous souhaitez dépenser dans cette requête
type	facultatif, string	basic (par défaut), normal, advanced
lang	facultatif, 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,
              ...
          ]
        }
      ]