🧭 Obtendo a lista de bairros de uma cidade

Exemplo de uso

Há duas opções para consulta da lista de bairros:

Consulta por ID interno

GET https://api.brasilaberto.com/v1/districts/{cityId}

Nesse caso, o parâmetro cityId é o ID da cidade na nossa base, ele é retornado na API de cidades e também na consulta de CEPs.

Consulta por código do IBGE

GET https://api.brasilaberto.com/v1/districts-by-ibge-code/{ibgeCode}

Nesse caso, o ibgeCode é o código identificador da cidade, de acordo com a base do IBGE.

Supondo que você queira buscar os bairros de Nova Iguaçu:

// Esse exemplo mostra somente parte dos resultados
// GET https://api.brasilaberto.com/v1/districts/669
{
  "meta": {
    "currentPage": 1,
    "itemsPerPage": 1910,
    "totalOfItems": 1910,
    "totalOfPages": 1
  },
  "result": [
    {
      "id": 1,
      "name": "Sé"
    },
    {
      "id": 2,
      "name": "Centro"
    },
    {
      "id": 3,
      "name": "Brás"
    },
    {
      "id": 4,
      "name": "República"
    },
    ...
  ]
}

Status de retorno

200 Sucesso
404 IbgeCode inexistente
500 Erro na nossa API