Buscar estados por cidade
A Country Data API fornece informações detalhadas sobre +200 países diferentes
HTTP GET
https://api.countrydataapi.com/v1/countries/city
Retorna o estado que possui essa cidade.
Alguns exemplos da estrutura
País: EUA, Estado: Colorado, Cidade: Denver
País: Espanha, Estado: Comunidade Valenciana, Cidade: Valência
Informações relevantes
Tenha em mente que há muitas cidades com o mesmo nome
Existem 3 tipos de operações:
-
BASIC: Os campos id, state_name, lang são retornados. Cada estado gastará 1 token
-
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 |
city | obrigatório, string | Nome da cidade que está no estado |
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,
...
]
}
]