Naar hoofdinhoud

Opnames

GET https://scintillating-wolf-799.eu-west-1.convex.site/v1/recordings

Opnames van events binnen een periode, met het event waar ze bij horen en of ze af te spelen zijn. De video zelf en de verwijzingen naar het videoplatform komen niet mee.

Rechten: recordings:read. Deze gegevens gaan niet over personen.

Maximaal 120 verzoeken per uur per sleutel. Daarboven krijg je rate_limited (429); de header Retry-After zegt na hoeveel seconden het weer kan.

Dit endpoint geeft de opnames van de events in een periode. Elke opname staat erbij met het event waar hij bij hoort, de titel, de status en of hij af te spelen is. Om hem te bekijken vraag je daarna per opname een speeladres op bij recordings/player-url.

from en to zijn verplicht en de periode is hoogstens 31 dagen. Dat houdt elk antwoord klein, ook bij een omgeving met jaren aan wekelijkse calls. Wil je een langere periode, haal die dan in stukken op. Het filter kijkt naar het moment van het event, niet naar wanneer de opname klaar was.

Hoort één call bij meerdere events, bijvoorbeeld bij twee producten tegelijk, dan heeft elk event een eigen opname met dezelfde video. Je ziet ze dus allebei, elk met een eigen eventId. Geef eventId mee als je alleen de opname van één event wilt.

playable is true als de opname gepubliceerd is en er een video aan hangt. Alleen voor zo'n opname geeft recordings/player-url een adres. Een opname die nog verwerkt wordt staat er al in, met status processing.

Parameters

Naam Uitleg
from verplicht Begin van de periode, in epoch-milliseconden. Telt mee.
to verplicht Eind van de periode, in epoch-milliseconden. Moet na from liggen, en hoogstens 31 dagen later. Telt mee.
eventId Alleen de opnames van dit event.
limit Aantal items per pagina, 1 tot en met 500. Standaard 100. Een waarde daarbuiten geeft een fout in plaats van een stille correctie.
cursor De nextCursor uit het vorige antwoord. Blijf doorbladeren tot nextCursor null is, ook als een pagina niet vol zit.

Voorbeeld

curl "https://scintillating-wolf-799.eu-west-1.convex.site/v1/recordings?from=…" \
  -H "Authorization: Bearer <je sleutel>"

Antwoord

{
  "items": [
    {
      "id": "pr3…",
      "eventId": "pe8…",
      "eventTitle": "Maandelijkse Q&A",
      "eventDatetime": 1759334400000,
      "title": "Q&A oktober",
      "status": "published",
      "playable": true
    }
  ],
  "nextCursor": null
}

Velden

Veld Type Betekenis
id string Vaste verwijzing naar deze opname. Gebruik hem bij recordings/player-url.
eventId string Het event waar de opname bij hoort.
eventTitle string Titel van het event.
eventDatetime getal Begin van het event, in epoch-milliseconden.
title string Titel van de opname. Heeft de opname geen eigen titel, dan die van het event.
status string processing, published, draft of failed.
playable boolean Of recordings/player-url voor deze opname een speeladres geeft.

Veelgestelde vragen

Waarom staat het videoadres niet in de lijst?
Een lijst wordt vaak opgeslagen en gedeeld, en een speeladres hoort niet bewaard te worden. Daarom vraag je het per opname op bij recordings/player-url, en wordt elke afgifte vastgelegd.
Welke statussen kan een opname hebben?
processing terwijl de video nog verwerkt wordt, published als hij klaar en zichtbaar is, draft als hij nog niet getoond wordt, en failed als het verwerken misging.
Waarom krijg ik een lege lijst bij een eventId dat bestaat?
Dan hoort dat event bij een andere omgeving, of valt het buiten de periode van from en to. Het antwoord is met opzet hetzelfde als bij een event zonder opname.

Hierna nodig

Werkt je aanroep niet zoals verwacht, kijk dan bij de foutcodes en wat ze betekenen. Heb je nog geen sleutel, dan legt de kennisbank uit hoe je er een aanmaakt.