GET https://api.mave.io/v1/collections
Gibt die Sammlungen direkt in einem Ordner zurück, sortiert nach Erstellungsdatum (neueste zuerst). Ohne collection werden nur Sammlungen auf der obersten Ebene des Space zurückgegeben. Die Liste ist nicht rekursiv und ist paginiert, standardmäßig mit 15 Einträgen pro Seite. Erfordert das API-Token.
Der video_count einer Sammlung umfasst auch Videos in verschachtelten Sammlungen. Der Wert kann daher höher sein als die Anzahl der Videos direkt in der Sammlung.
| Param | Typ |
|---|---|
| page | positive Ganzzahl (Standard: 1) |
| per_page | positive Ganzzahl (Standard: 15, max. 100) |
| collection | Sammlungs-ID; gibt nur direkte Untersammlungen zurück. Weglassen oder leer lassen für die oberste Ebene des Space. |
| archived | boolean; true gibt archivierte Sammlungen zurück. Ohne diesen Parameter oder bei false werden aktive Sammlungen zurückgegeben. |
{
"current_page": 1, // the page you are looking at
"data": [
{
"created": 1683272297,
"id": "zlb1cnE31EQetyx",
"name": "test", // name of the collection
"object": "collection", // type of the object
"video_count": 3 // the amount of videos in this collection
},
{
"created": 1683190633,
"id": "zlb1cAvWg15i9NW",
"name": "Collection",
"object": "collection",
"video_count": 0
}
], // all the collections 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": 2, // the total of video embeds
"total_pages": 1 // the total pages that are available
}