Buscar estados por cidade
Country Data API fornece informações detalhadas sobre +200 países diferentes
HTTP GET
https://api.countrydataapi.com/v1/states/city
Retorna o estado que tem essa cidade.
Alguns exemplos da estrutura
País: EUA, Estado: Colorado, Cidade: Denver
País: Espanha, Estado: Comunidade Valenciana, Cidade: Valencia
Informação relevante
Tenha em conta que há muitas cidades com o mesmo nome
Dependendo dos campos solicitados, haverá 3 tipos de requisições:
BÁSICO: São retornados os campos id, state_name, lang Cada estado gastará 1 token
NORMAL: É retornado o campo state_cities [Todos os ids e nomes das cidades do estado] Cada cidade gastará 1 token
AVANÇADO: É retornado o campo state_zip_codes [Todos os códigos postais da cidade] Cada código postal 1 token
Parâmetros de Consulta
Parâmetro | Tipo | Descrição |
---|---|---|
apikey | obrigatório, token | Chave de autenticação da conta |
city | obrigatório, string | Nome da cidade que se encontra no estado |
limitToken | opcional, number | 1000 (padrão). Número máximo de tokens que você quer gastar nesta requisição |
fields | opcional, string | id,lang,state_name (padrão). Campos esperados na resposta |
lang | opcional, lang | 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,
...
]
}
]