For the complete documentation index, see llms.txt. This page is also available as Markdown.
API - Calendários e Reuniões
Este guia ensina como obter informações dos calendários e seus respectivos agendamentos. O processo é dividido em duas etapas principais: a listagem dos calendários disponíveis e a consulta de reuniões por período.
1. Listagem de Calendários
O primeiro passo é recuperar a lista de calendários associados ao usuário ou sistema. Este endpoint utiliza uma estrutura de query para filtrar os campos desejados.
Endpoint: GET /pcalendar
Parâmetros de Query: query: Define os campos de retorno (ex: id, name, isPublished, etc).
Exemplo de Requisição
GET /pcalendar?query={calendars{id,name,isPublished,createDate,userId,updateDate,publicId,userId,nextMeeting}}
Dica:
Guarde o id (ou publicId) do calendário retornado nesta chamada, pois ele será obrigatório para o próximo passo.
2. Consulta de Reuniões por Calendário
Após identificar o ID do calendário, você pode listar todas as reuniões agendadas dentro de um intervalo de tempo específico.
Endpoint: GET /calendarmeeting/{calendarId}
Parâmetros de URL e Query:
calendarId (Path): O identificador numérico do calendário (ex: 71).
page: Índice da página para paginação (inicia em 0).
from: Data de início no formato ISO 8601.
Exemplo de Requisição
GET /calendarmeeting/71?page=0&from=2026-04-01T03:00:00.000Z
Resumo do Fluxo
Chamada Inicial: Execute o GET em /pcalendar para obter o mapeamento de calendários.
Seleção: O usuário ou sistema escolhe um id da lista retornada.
Recuperação: Execute o GET em /calendarmeeting/{id} passando os parâmetros de tempo e página para exibir as reuniões.
Notas Técnicas
Formato de Data: Certifique-se de enviar as datas no padrão UTC (Z) para evitar conflitos de fuso horário.
Paginação: O parâmetro page é essencial para calendários com alto volume de reuniões.
