Desenvolvedores

Versões e mudanças da API

Histórico de versões da API v1, dos webhooks e do servidor MCP do CliLink, e a regra de compatibilidade.

Compatibilidade

A versão vai no endereço (/api/v1). Dentro da v1, só entram mudanças compatíveis: rota nova, campo novo na resposta, parâmetro novo opcional.
Seu código deve ignorar campos que não conhece. Remover ou mudar o sentido de um campo só numa v2, avisada aqui com antecedência.
Webhooks seguem a mesma regra: evento e campo novos podem aparecer; o formato da assinatura (t=...,v1=...) não muda na v1.

MCP com login do CliLink (OAuth 2.1, especificação de autorização do MCP 2025-11-25): conecta o claude.ai, o ChatGPT e outros apps que pedem login.
Metadata em /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server; registro dinâmico de cliente; PKCE S256 obrigatório; indicador de recurso.
Token de acesso de 1 hora e renovação rotativa de 30 dias; revogação pelo app (/api/oauth/revoke) e pelo painel (Integrações > Apps).
O MCP continua aceitando o token da API (clk_...).

Agenda: listar, ver, marcar, aprovar, remarcar e cancelar consultas; horários livres; tipos de consulta e locais.
Pacientes: listar, buscar, ver, cadastrar e atualizar (só cadastro, nunca prontuário).
Contatos da página, sinais e recebimentos do mês, cobrança do sinal de uma consulta.
Página: ler e editar textos das seções, publicar e tirar do ar, números da página.
Webhooks pela API (permissão webhooks:manage).
Tokens com permissões (escopos), validade opcional e vários por conta; limite por token.
Erro no formato { erro: { codigo, mensagem } } (o campo error de antes continua).
Paginação por cursor, Idempotency-Key nos POST e registro de uso no painel.
OpenAPI 3.1 em app.clilink.bio/api/v1/openapi.json e servidor MCP em app.clilink.bio/api/mcp.

Webhooks: consulta.criada, consulta.confirmada, consulta.cancelada, consulta.remarcada, sinal.pago, contato.novo e paciente.criado, com assinatura HMAC.

Atualizada em 21/10/2026. Dúvida ou algo faltando? contato@clilink.bio.