Documentação

A Country Data API fornece informações detalhadas sobre +200 países diferentes

HTTP GET

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

Retorna o estado que possui esse país.

Alguns exemplos da estrutura

País: EUA, Estado: Colorado, Cidade: Denver

País: Espanha, Estado: Comunidade Valenciana, Cidade: Valência

Existem 3 tipos de operações:

• BASIC: Os campos id, state_name, lang são retornados.

• NORMAL: O campo state_cities é retornado [Todos os id e nome das cidades do estado]. Cada cidade gastará 1 token

• ADVANCED: O campo state_zip_codes é retornado [Todos os códigos postais da cidade]. Cada código postal 1 token

Parâmetros da consulta

Parâmetro	Tipo	Descrição
apikey	obrigatório, token	Chave de autenticação da conta
country	obrigatório, string	Nome do país do qual deseja-se os estados
limitToken	opcional, número	1000 (padrão). Número máximo de tokens que você deseja gastar nesta solicitação
type	opcional, string	básico (padrão), normal, avançado
lang	opcional, idioma	en (padrão). Idioma esperado da resposta

Exemplo de resposta

    [
        {
          "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,
              ...
          ]
        }
      ]