API

Video aktualisieren

PUT https://api.mave.io/v1/videos/{id}

Sie können ein Video in eine andere Sammlung verschieben. Wenn null als Sammlung bereitgestellt wird, wird es in das Stammverzeichnis des Speicherplatzes verschoben (oder, wenn es archiviert wird, in das Stammverzeichnis des Archivs).

Private Videos

Senden Sie visibility: "private", um ein Wiedergabe-JWT zu verlangen, oder visibility: "public" für öffentlichen Zugriff. Dafür ist ein API-Schlüssel mit Lese- und Schreibrechten nötig. Neue Videos sind standardmäßig öffentlich. Siehe Geschützte Videowiedergabe.

Sichtbarkeitsänderungen werden im Hintergrund verarbeitet. Eine laufende Änderung liefert 202 Accepted mit der zuletzt bestätigten visibility. Wiederholen Sie GET /v1/videos/{id}, bis 200 OK mit dem gewünschten Wert (public oder private) zurückgegeben wird. Während der Verarbeitung liefert auch GET 202.

Anfrage (optional)

{
  "name": "new name", // set new name
  "collection": "ubg50fRgMoWlCUU" // to move to another collection
}

Antwort

{
  "created": 1643723737, // when this video embed was created
  "duration": null, // duration of the video
  "width": null, // width of the video in pixels
  "height": null, // height of the video in pixels
  "id": "ubg50apemJaHEYZ", // the ID if you want to store it for your user and possibly webhooks
  "last_upload": null, // when a video has been uploaded
  "name": null, // name of the file or chosen name
  "visibility": "public",
  "object": "video", // the type of object you're looking at
  "poster_image": null, // uploaded poster or first frame of video when uploaded
  "size": null, // size of the video
  "renditions": [],
  "subtitles": []
}