API para desenvolvedores

Consulte zoneamento, parâmetros urbanísticos, potencial construtivo e restrições por lote, a partir da base oficial das prefeituras integradas.

Base URL

https://api.zonaviavel.com.br

Autenticação

Toda chamada exige uma API key no header X-API-Key. As chaves são emitidas pelo administrador do ZonaViável (e mostradas uma única vez na criação).

X-API-Key: zv_suachavesecreta

Limites

Cada chave pode ter um limite mensal de chamadas. Ao exceder, a API responde 429. O contador zera no início de cada mês.

Endpoints

GET/public/v1/municipios

Lista as cidades disponíveis e quantas zonas cada uma tem.

curl -H "X-API-Key: zv_..." \
  https://api.zonaviavel.com.br/public/v1/municipios

GET/public/v1/zonas/{municipio_slug}

Tabela de índices urbanísticos da cidade: por zona, taxa de ocupação, coeficiente de aproveitamento, gabarito, usos permitidos e observações.

curl -H "X-API-Key: zv_..." \
  https://api.zonaviavel.com.br/public/v1/zonas/blumenau

POST/public/v1/consultar

Consulta por coordenada: identifica o lote (área real, zona(s)), calcula o potencial construtivo e detecta as restrições que incidem sobre ele.

Requisição

curl -X POST -H "X-API-Key: zv_..." \
  -H "Content-Type: application/json" \
  https://api.zonaviavel.com.br/public/v1/consultar \
  -d '{"municipio_slug":"blumenau","lat":-26.90,"lng":-49.075}'

Resposta (resumida)

{
  "municipio": "Blumenau/SC",
  "lote": {
    "inscricao_cadastral": "4-1-18-7-284",
    "area_m2": 10458.84,
    "bairro": "ITOUPAVA SECA",
    "zonas": ["ZC2", "ZPA"]
  },
  "zona": {
    "codigo": "ZPA",
    "nome": "Zona de Proteção Ambiental",
    "taxa_ocupacao": 0.3,
    "coef_aproveitamento": 0.6,
    "usos_permitidos": ["Residencial unifamiliar", "..."]
  },
  "potencial": {
    "area_terreno_m2": 10458.84,
    "area_projecao_max_m2": 3137.65,
    "area_construtiva_basica_m2": 6275.3,
    "pavimentos_estimados": 2
  },
  "restricoes": [
    { "nome": "Área de Influência de Aeródromo (AIA/AIAH)", "detalhe": "PZPANA" },
    { "nome": "Perigo/risco geológico", "detalhe": "Alto Perigo ou Risco" }
  ],
  "revisado": true,
  "aviso": "Lote multi-zona (ZC2, ZPA): os índices podem ser somados..."
}

Códigos de erro

401	API key ausente, inválida ou revogada
404	Município não configurado ou lote/zona não encontrados
429	Limite mensal da API key atingido

As restrições são detectadas a partir da base da prefeitura e não dispensam a análise do órgão competente. Os parâmetros refletem a legislação vigente integrada, mas a consulta oficial prevalece.

Documentação interativa (Swagger): https://api.zonaviavel.com.br/docs

Para obter uma chave, fale com a gente.