Eine Textspur abrufen

Textspur abrufen

Zum Abrufen einer einzelnen Textspur sendest du eine GET-Anfrage an den Endpoint /videos/:videoId/texttracks/:texttrackId.

CURL


curl -X GET https://app.ignitevideo.cloud/api/videos/[VIDEO_ID]/texttracks/[TEXTTRACK_ID] \
-H "Authorization: Bearer YOUR_TOKEN"

JavaScript / Node.js


const response = await fetch(`https://app.ignitevideo.cloud/api/videos/${videoId}/texttracks/${texttrackId}`, {
headers: {
  Authorization: `Bearer YOUR_TOKEN`
}
});

PHP


$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://app.ignitevideo.cloud/api/videos/'.$videoId.'/texttracks/'.$texttrackId, [
'headers' => [
  'Authorization' => 'Bearer YOUR_TOKEN'
]
]);

API-Antwort

Die Antwort ist ein Textspur-Objekt mit den Metadaten der Spur und dem Inhalt.


{
  "id": string,
  "language": "en" | "en-US" | "de" | "de-DE" | "it" | "fr" | "...",
  "type": "subtitles" | "captions",
  "filename": string,
  "url": string,
  "content": string // WebVTT formatted string
}

Die Eigenschaft content enthält die vollständigen Textspur-Daten als mit WebVTT kompatiblen String.

Fehlerantwort (404)

Wenn die Textspur nicht gefunden wird, wird der Statuscode 404 mit einer passenden Fehlermeldung zurückgegeben.


{
  "errors": [
    {
      "message": "The requested resource could not be found."
    }
  ]
}