Naar hoofdinhoud

Speeladres van een opname

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

Geeft voor één opname het adres van de videospeler, om in een iframe te tonen. Elke afgifte wordt vastgelegd, en het adres hoort niet bewaard te worden.

Rechten: recordings:play. Deze gegevens gaan over personen.

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

Met dit endpoint toon je een opname in je eigen toepassing. Je geeft het id uit recordings mee en krijgt het adres van de videospeler terug, dat je in een iframe zet. Vraag het adres pas op als iemand de opname wil bekijken, en bewaar het niet.

expiresAt zegt tot wanneer het adres werkt. Bij null heeft het adres nu geen vervaldatum, maar dat kan later een adres worden dat maar kort geldig is. Vraag daarom bij elke keer afspelen een nieuw adres op, dan blijft je toepassing werken als dat verandert.

Je krijgt dezelfde 404 voor een opname die niet bestaat, bij een andere omgeving hoort, nog niet gepubliceerd is of geen video heeft. Kijk vooraf naar playable in recordings als je wilt weten of een opname af te spelen is.

Elke afgifte wordt vastgelegd, met de sleutel die erom vroeg en het tijdstip. Het adres zelf wordt niet bewaard. Dit endpoint heeft een lagere limiet dan de lijst, omdat het bij een kijkmoment hoort en niet bij het bijhouden van een overzicht.

Parameters

Naam Uitleg
id verplicht Het id van de opname, uit recordings.

Voorbeeld

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

Antwoord

{
  "items": [
    {
      "id": "pr3…",
      "url": "https://speler.voorbeeld.test/embed/…",
      "expiresAt": null
    }
  ],
  "nextCursor": null
}

Velden

Veld Type Betekenis
id string De opname waar dit adres bij hoort.
url string Adres van de videospeler, voor in een iframe.
expiresAt getal of null Tot wanneer het adres werkt, in epoch-milliseconden. Null als het adres nu geen vervaldatum heeft.

Veelgestelde vragen

Waarom is dit een aparte aanroep en geen veld in de lijst?
Zo komt een speeladres alleen tevoorschijn als iemand echt wil kijken, en is elke afgifte terug te vinden. Een adres in een lijst zou mee worden opgeslagen.
Mag ik het adres opslaan?
Nee. Vraag het op bij elke keer afspelen. Een opgeslagen adres kan verlopen, en wie het vindt kan de opname bekijken zonder sleutel.
Waarom krijg ik een 404 op een id uit de lijst?
Dan is de opname nog niet gepubliceerd of heeft hij geen video, wat je ziet aan playable false. Een opname van een andere omgeving geeft dezelfde 404.

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.