API para consultar todos os estados e cidades do Brasil
https://br-cidades-estados-nodejs.herokuapp.com/estados
- Instalação
$ npm install
- Iniciar aplicação
$ npm start
Acessar http://localhost:3000/estados no navegador e seguir a documentação para fazer outras chamadas na API.
GET /estados
[
{
"id": "AC",
"estado": "Acre"
},
{
"id": "AL",
"estado": "Alagoas"
},
{
"id": "AM",
"estado": "Amazonas"
},
]
GET /estados?_sort=id
GET /estados?_sort=id&_order=asc
GET /estados?_sort=id&_order=desc
GET /estados?_sort=estado
GET /estados?_sort=estado&_order=asc
GET /estados?_sort=estado&_order=desc
GET /estados?q=Ama
[
{
"id": "AM",
"estado": "Amazonas"
},
{
"id": "AP",
"estado": "Amapá"
}
]
GET /estados?q=Amazonas
[
{
"id": "AM",
"estado": "Amazonas"
}
]
GET /estados?q=RR
[
{
"id": "RR",
"estado": "Roraima"
}
]
GET /estados?id=SP
GET /estados?estado=São Paulo
GET /estados?id=SP&id=RJ
GET /estados?id=SP&id=RJ&_sort=id&_order=asc
GET /estados?id=SP&id=RJ&_sort=id&_order=desc
GET /estados?id=SP&id=RJ&_sort=estado&_order=asc
GET /estados?id=SP&id=RJ&_sort=estado&_order=desc
GET /estados?estado=São Paulo&estado=Rio de Janeiro
GET /estados?estado=São Paulo&estado=Rio de Janeiro&_sort=id&_order=asc
GET /estados?estado=São Paulo&estado=Rio de Janeiro&_sort=id&_order=desc
GET /estados?estado=São Paulo&estado=Rio de Janeiro&_sort=estado&_order=asc
GET /estados?estado=São Paulo&estado=Rio de Janeiro&_sort=estado&_order=desc
GET /estados?_page=1
GET /estados?_page=1&_limit=5
- No header é retornado os links para as páginas -
primeira, anterior, próxima e última
:
Link: </estados?_page=1&_limit=5>; rel="first", </estados?_page=1&_limit=5>; rel="prev", </estados?_page=3&_limit=5>; rel="next", </estados?_page=6&_limit=5>; rel="last"
GET /estados/:id
GET /estados/DF
GET /estados/:id/cidades
GET /estados/DF/cidades
{
"id": "DF",
"estado": "Distrito Federal",
"cidades": [
{
"estadoId": "DF",
"cidade": "Brasília",
"capital": true
}
]
}
GET /estados/:id/cidades?_sort=id
GET /estados/:id/cidades?_sort=id&_order=asc
GET /estados/:id/cidades?_sort=id&_order=desc
GET /estados/SP/cidades?_sort=cidade
GET /estados/SP/cidades?_sort=cidade&_order=asc
GET /estados/SP/cidades?_sort=cidade&_order=desc
GET /estados/:id/cidades?q=
GET /estados/SP/cidades?q=ilha
[
{
"estadoId": "SP",
"cidade": "Ilha Comprida"
},
{
"estadoId": "SP",
"cidade": "Ilha Solteira"
},
{
"estadoId": "SP",
"cidade": "Ilhabela"
}
]
GET /estados/:id/cidades?cidade=
GET /estados/SP/cidades?cidade=Ilhabela
[
{
"estadoId": "SP",
"cidade": "Ilhabela"
}
]
GET /estados/SP/cidades?cidade=Ilhabela&cidade=Embu
GET /estados/SP/cidades?cidade=Ilhabela&cidade=Embu&_sort=cidade&_order=desc
GET /estados/SP/cidades?cidade=Ilhabela&cidade=Embu&_sort=cidade&_order=asc
GET /estados/SP/cidades?_page=1
GET /estados/SP/cidades?_page=1&_limit=5
- No header é retornado os links para as páginas -
primeira, anterior, próxima e última
:
Link: </estados/SP/cidades?_page=1&_limit=5>; rel="first", </estados/SP/cidades?_page=1&_limit=5>; rel="prev", </estados/SP/cidades?_page=3&_limit=5>; rel="next", </estados/SP/cidades?_page=129&_limit=5>; rel="last"
Listar todas as cidades que são capitais:
GET /capitais
GET /cidades?capital=true
GET /cidades?capital=true&estadoId=SP
GET /cidades?capital=true&estadoId=SP&estadoId=RJ
[
{
"estadoId": "AC",
"cidade": "Rio Branco",
"capital": true
},
]
@giovanigenerali |
---|