> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/topicos/api/api-calendarios-e-reunioes.md).

# 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}}`

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FWRiRMW3pHXBM0Crw6ijp%2Fimage.png?alt=media&amp;token=0a1f0a41-3608-4013-beed-8efa97de2926" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}

### Dica:

Guarde o id (ou publicId) do calendário retornado nesta chamada, pois ele será obrigatório para o próximo passo.
{% endhint %}

***

#### 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`

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FXC8Mt0lroIMxWW5sdVKU%2Fimage.png?alt=media&amp;token=41d06445-546c-47a9-8b0b-00244b848d39" alt=""><figcaption></figcaption></figure>

***

#### Resumo do Fluxo

1. Chamada Inicial: Execute o GET em `/pcalendar` para obter o mapeamento de calendários.
2. Seleção: O usuário ou sistema escolhe um id da lista retornada.
3. 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.
