KnoVet para desenvolvedores e agentes

Referência OpenAPI

A especificação OpenAPI 3.1.1 da KnoVet descreve os formatos de resposta, os endereços dos servidores e as duas consultas JSON abaixo. O escopo é de leitura: cadastros, solicitações de atendimento e ações dos portais não fazem parte deste contrato. Para outras integrações, fale com a equipe.

Autenticação e acesso

As operações GET documentadas aqui são públicas e não exigem chave de API, token, sessão ou cookie. A base das consultas JSON é https://knovet-backend.vercel.app; as páginas e os arquivos de descoberta estão em https://www.knovet.com. Permissões de portais e operações de escrita são separadas desta referência.

Respeite as regras de rastreamento de cada host e os termos de uso. O backend não é destinado à indexação por buscadores. Uma falha de acesso ou consulta não representa uma lista vazia: confira o status HTTP antes de interpretar a resposta.

Homepage em HTML ou Markdown

Solicite Accept: text/markdown na homepage para receber Markdown, com Content-Type: text/markdown e Vary: Accept. Use Accept: text/html para HTML. Preferências e pesos do cabeçalho são respeitados; um pedido que rejeite ambos os formatos recebe HTTP 406. O conteúdo principal também está no HTML inicial, sem execução de JavaScript.

curl -sS -L -i -H 'Accept: text/markdown' 'https://www.knovet.com/'
curl -sS -L -i -H 'Accept: text/html' 'https://www.knovet.com/'

A URL /index.md oferece o mesmo conteúdo em Markdown para clientes que não configuram o cabeçalho Accept.

Índice de parceiros ativos

GET /api/v1/landing/partner-index retorna um objeto JSON com data: uma lista de parceiros com slug, type, city, state, neighborhood (texto ou nulo) e directoryEligible (booleano). Não há filtros nem paginação nessa operação. Uma lista vazia indica que não há parceiros retornados na consulta.

curl -sS --fail-with-body -H 'Accept: application/json' 'https://knovet-backend.vercel.app/api/v1/landing/partner-index'

O índice informa dados cadastrais, sem disponibilidade de agenda. Use o catálogo de parceiros para consultar os perfis, serviços e contatos atuais. Preços e horários devem ser confirmados com a unidade.

Indicadores agregados

GET /api/v1/landing/stats retorna data.activePartnersCount, a quantidade de parceiros ativos, e data.petsScheduledCount, a quantidade de pets distintos em solicitações não canceladas. Ambos são inteiros não negativos. Não há parâmetros nessa operação nem dados pessoais na resposta.

curl -sS --fail-with-body -H 'Accept: application/json' 'https://knovet-backend.vercel.app/api/v1/landing/stats'

Esses totais são calculados pela plataforma e podem diferir dos números de apresentação da homepage. Uma solicitação não confirma que uma consulta ocorreu. Em uma falha de consulta, a API retorna HTTP 500 com error, message e requestId; aguarde antes de tentar novamente.

Descoberta do conteúdo público

• /llms.txt: apresentação da KnoVet e links para o conteúdo público.
• /sitemap.xml: URLs canônicas de páginas e perfis publicados.
• /robots.txt: regras de rastreamento do site.
• /openapi.json: contrato de leitura em formato OpenAPI.

A KnoVet conecta tutores e prestadores. A unidade escolhida confirma disponibilidade, data, horário, preço e condições de atendimento diretamente com o tutor.