Pular para o conteúdo principal
GET
/
api
/
v1
/
calendars
/
events
curl "https://app.talkover.ai/api/v1/calendars/events?calendar_ids[]=cal-1&calendar_ids[]=cal-2&from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": [
    {
      "id": "event-uuid-1",
      "calendar_id": "cal-1",
      "title": "Demo with Loja Brasil",
      "start_at": "2024-01-15T15:00:00Z",
      "end_at": "2024-01-15T15:30:00Z",
      "status": "confirmed"
    }
  ]
}

​
Obter Eventos (Lote)

Recuperar eventos de múltiplos calendários em uma única requisição, opcionalmente filtrados por intervalo de tempo. Útil para renderizar uma visão unificada de calendário entre equipes.

​
Endpoint

GET /api/v1/calendars/events

​
Parâmetros de consulta

​
calendar_ids[]
array
obrigatório
Um ou mais UUIDs de calendário. Repita o parâmetro para múltiplos valores.
​
from
string
Limite inferior do horário de início do evento. ISO 8601.
​
to
string
Limite superior do horário de término do evento. ISO 8601.

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

​
Exemplos

curl "https://app.talkover.ai/api/v1/calendars/events?calendar_ids[]=cal-1&calendar_ids[]=cal-2&from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Resposta

{
  "success": true,
  "data": [
    {
      "id": "event-uuid-1",
      "calendar_id": "cal-1",
      "title": "Demo with Loja Brasil",
      "start_at": "2024-01-15T15:00:00Z",
      "end_at": "2024-01-15T15:30:00Z",
      "status": "confirmed"
    }
  ]
}