Lesync API — OpenAPI e calendário

A especificação OpenAPI 3.0.3 descreve as interfaces de leitura existentes no Lesync. Cada operação tem um identificador único, descrição, formatos e schemas de resposta. O contrato inclui a apresentação do produto, a documentação e a assinatura de calendário; não publica uma API de administração de escolas.

Documentos públicos

Use GET nas páginas listadas no sitemap. O formato padrão é HTML; envie o cabeçalho HTTP Accept: text/markdown para receber Markdown na mesma URL. Uma preferência incompatível retorna 406. O índice para agentes e a documentação completa são servidos como text/plain, sem autenticação.

Assinatura de calendário

GET /api/calendar recebe a credencial de assinatura no parâmetro de consulta token e retorna text/calendar no formato iCalendar. A resposta contém aulas agendadas e de reposição do assinante, conforme seu vínculo e sua função. O calendário é privado e pode conter anotações e links de reunião. O controle de exportação da agenda permite gerar, substituir ou revogar o link. Veja autenticação no Lesync.

Respostas: 200 entrega o calendário; 401 indica token ausente, inválido ou já revogado; 410 indica expiração ou ausência de função elegível; 429 indica limite de consultas. Os erros são texto simples. Aguarde o número de segundos informado em Retry-After antes de repetir uma consulta limitada.

O calendário admite uma consulta bem-sucedida por token a cada 60 segundos. As rotas /api/ também compartilham um limite de 100 requisições por IP a cada 60 segundos por instância; esse controle é de melhor esforço, não uma cota global garantida. A leitura não altera aulas.

Ferramentas de agentes

Clientes podem importar o OpenAPI para descobrir operações HTTP. A credencial CalendarToken deve ser configurada no armazenamento seguro do cliente, sem incluí-la em instruções para modelos. O MCP do Lesync oferece ferramentas tipadas para documentação pública, sem receber tokens de calendário. Para automações de dados da escola além dessa assinatura, fale com a equipe.