Skip to content

API do IBGE

Este módulo da API fornece acesso a dados geográficos do IBGE (Instituto Brasileiro de Geografia e Estatística), como estados e municípios, que podem ser utilizados para validação de endereços ou outras funcionalidades relacionadas à localização.

Endpoints

  • Listar Estados: Retorna uma lista de todos os estados brasileiros.
    • GET /api/ibge/states
  • Listar Municípios por Estado: Retorna uma lista de municípios para um estado específico.
    • GET /api/ibge/states/{uf}/municipalities

Códigos de Status HTTP

  • 200 OK: Dados retornados com sucesso.
  • 400 Bad Request: Parâmetros inválidos.
  • 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
  • 404 Not Found: Recurso não encontrado (ex: estado não existe).
  • 500 Internal Server Error: Erro interno do servidor.