API

Videos auflisten

GET https://api.mave.io/v1/videos

Gibt die Videos direkt in einem Ordner zurück, sortiert nach Erstellungsdatum (neueste zuerst). Ohne collection werden nur Videos auf der obersten Ebene des Space zurückgegeben, nicht Videos in Sammlungen. Die Ergebnisse sind paginiert, standardmäßig mit 15 Einträgen pro Seite. Erfordert das API-Token.

Abfrageparameter

Param	Typ
page	positive Ganzzahl (Standard: 1)
per_page	positive Ganzzahl (Standard: 15, max. 100)
uploaded	boolean; mit `true` oder `false` nach Uploadstatus filtern. Ohne diesen Parameter werden beide zurückgegeben.
archived	boolean; `true` gibt archivierte Einträge zurück. Ohne diesen Parameter oder bei `false` werden aktive Einträge zurückgegeben.
collection	Sammlungs-ID; gibt nur direkte Inhalte zurück. Weglassen oder leer lassen für die oberste Ebene des Space.
show_collections	boolean; bei `true` werden direkte Untersammlungen ebenfalls in `data` aufgenommen.

Antwort

{
  "current_page": 1, // the page you are looking at
  "data": [
    {
      "created": 1643723823,
      "duration": 0.108333, // duration of the video
      "width": 1920, // width of the video in pixels
      "height": 1080, // height of the video in pixels
      "id": "IIzFKHuukg", // this can be used to put into the component
      "last_upload": 1643746229,
      "name": "test.mp4", // name of the file or chosen name
      "object": "video",
      "poster_image": "https://image.mave.io/IIzFKHuukg.jpg?time=0", // defaults to first frame of the video
      "size": 358923, // size of the video in bytes
      "renditions": ["sd", "hd"], // size of the video
      "subtitles": ["en", "nl"] // available subtitles
    },
    {
      "created": 1643723737,
      "duration": null,
      "width": null,
      "height": null,
      "id": "k1iFD7h4rW",
      "last_upload": null,
      "name": null, // empty embed
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": [],
      "subtitles": []
    },
    {
      "created": 1643723523,
      "duration": null,
      "width": null,
      "height": null,
      "id": "NyzCJgb28a",
      "last_upload": null,
      "name": null,
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": [],
      "subtitles": []
    },
    {
      "created": 1643723504,
      "duration": null,
      "width": null,
      "height": null,
      "id": "rV4k65cLmE",
      "last_upload": null,
      "name": null,
      "object": "video",
      "poster_image": null,
      "size": null,
      "renditions": [],
      "subtitles": []
    }
  ], // all the video embeds that have been created
  "has_more": false, // the possibility whether there are more video embeds to retrieve
  "object": "list", // the type of object you're looking at
  "total_items": 4, // the total of video embeds
  "total_pages": 1 // the total pages that are available
}