Pular para o conteúdo
Kondomino

Documentação

Changelog

Mudanças na API, da mais recente para a mais antiga. Campos novos entram sem mudar o prefixo /v1; uma mudança incompatível seria uma nova versão, anunciada aqui antes.

2026-11-17 — Ficha sem o campo `description`

A ficha (GET /v1/kondos/{slug}, GET /v1/demo/kondos/{slug} e a ferramenta MCP get_kondo) deixou de trazer o campo description. Ele reproduzia o texto da página de origem, que pertence a quem o escreveu; os fatos do condomínio continuam nos demais campos. Uma descrição própria, escrita a partir dos campos estruturados, pode voltar em uma versão futura.

2026-10-19 — Servidor MCP

Assistentes de IA (Claude, Cursor e outros clientes MCP) podem consultar o catálogo como ferramentas, em POST /mcp. Veja MCP.

  • Ferramentas: list_states e list_cities (não contam consulta), search_kondos e get_kondo (contam, como a busca e a ficha da API).
  • Sem chave, a demonstração (5 consultas por dia por IP); com chave, Authorization: Bearer kd_live_… e a cota da chave. O saldo é o mesmo da API REST.

2026-10-19 — v1

A primeira versão pública da API de dados de condomínios.

  • Demonstração sem chave: GET /v1/demo/kondos e GET /v1/demo/kondos/{slug}, 5 consultas por dia por IP, 10 por página, 2 páginas por busca. Também no simulador.
  • Listas de referência: /v1/states, /v1/cities, /v1/amenities e /v1/builders, sem chave e sem custo, com cache de 10 minutos.
  • Chaves de API no console: Authorization: Bearer kd_live_…, até 5 chaves ativas por conta, com rotação e revogação. GET /v1/me mostra a chave e o plano.
  • Busca e ficha com chave: GET /v1/kondos (resumo, com filtro de uf, city ou near obrigatório, e paginação por cursor assinado de 10 minutos) e GET /v1/kondos/{slug} (registro completo, com procedência).
  • Cota diária por chave (50 consultas no plano Grátis), renovada à meia-noite de São Paulo, com os cabeçalhos X-Quota-Limit, X-Quota-Remaining e X-Quota-Reset, e limite de 30 requisições por minuto.
  • Erros em application/problem+json com code estável, e o contrato em OpenAPI em GET /v1/openapi.json, que gera a referência.