api

Video bijwerken

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

Je kunt een video naar een andere collectie verplaatsen. Als je voor de collectie null opgeeft, wordt de video naar de hoofdmap van de space verplaatst. Een gearchiveerde video wordt naar de hoofdmap van het archief verplaatst.

Private video’s

Stuur visibility: "private" mee om een afspeel-JWT te vereisen, of visibility: "public" voor publieke toegang. Hiervoor is een API-sleutel met lees- en schrijfrechten nodig. Nieuwe video’s zijn standaard publiek. Zie Beveiligd video afspelen.

Het wijzigen van de zichtbaarheid gebeurt op de achtergrond. Een lopende wijziging geeft 202 Accepted terug met de laatst bevestigde visibility. Herhaal GET /v1/videos/{id} totdat je 200 OK met de gevraagde waarde (public of private) krijgt. Zolang de wijziging loopt, geeft GET ook 202 terug.

Request (optioneel)

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

Response

{
  "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": []
}