REST-API

Was du damit machen kannst

• Lade Videos direkt in den Speicher hoch, mit fortsetzbaren Uploads in Teilen von 16 MB für große Dateien.
• Importiere ein Video über einen Link zu einer Datei.
• Lies und verwalte deine Bibliothek und deine Webhooks aus deinem eigenen Code.
• Hol deine Analysen in ein Dashboard, eine Tabelle oder ein Data Warehouse (siehe Analysen unten).
• Gib jedem Schlüssel nur den Zugriff, den er braucht: Read only, Read & write videos oder Admin.

Analysen

Jeder Schlüssel, auch einer mit Read only, kann deine Analysen lesen. Jeder Zeitraum ist entweder days (die letzten N Tage, inklusive heute) oder from und to als Datum (YYYY-MM-DD, jeweils inklusive).

• GET /v1/stats: Summen, Wiedergaben pro Tag, alle Videos, Top-Seiten und UTM-Kampagnen für den Workspace, einen Ordner oder einen Tag. Mit ?format=csv für eine Tabellenkalkulation.
• GET /v1/videos/{id}/stats: ein einzelnes Video, mit Zuschauerbindung, Abschluss, Ländern und Geräten.
• GET /v1/analytics/sessions: jeder Aufruf, die ältesten zuerst, bis zu 1.000 auf einmal. Gib den Wert next als after zurück, um die nächste Seite zu bekommen. Jeder Aufruf enthält den Zuschauer (falls bekannt), wie viel er angesehen hat, ob er zu Ende geschaut hat, Land, Gerät, Seite, UTM-Tags und was er angeklickt oder abgeschickt hat.
• GET /v1/analytics/viewer?email=…: alles, was eine Person angesehen hat, pro Video, mit allen ihren Sitzungen zusammengefasst.
• POST /v1/analytics/report: ein eigener Bericht (Gruppierung und Kennzahlen wie unter Analytics → Reports), und GET /v1/analytics/reports/{id}/run führt einen Bericht aus, den dein Team dort gespeichert hat.
• GET /v1/analytics/compare?videos=… und GET /v1/analytics/live: Videos vergleichen und sehen, wer gerade zuschaut.

Einrichtung

1. Geh in Pellio zu Settings → Developers. Dafür musst du Inhaber oder Admin sein.
2. Erstelle einen Schlüssel: Gib ihm einen Namen und wähle seinen Zugriff (Access).
3. Kopiere den Schlüssel. Er wird nur einmal angezeigt, bewahre ihn also sicher auf.
4. Sende ihn als Bearer-Token: curl https://api.pellio.io/v1/videos -H "Authorization: Bearer pk_…"
5. Zum Hochladen rufst du POST /v1/videos/uploads auf, sendest die Datei per PUT an die zurückgegebene URL und rufst dann POST /v1/videos/{id}/complete auf. Ein Webhook video.ready sagt dir, wann sie verarbeitet ist.

Gut zu wissen

• Alle Endpunkte stehen in der API-Referenz, und das OpenAPI-Dokument liegt unter https://api.pellio.io/v1/openapi.json.
• Dateien müssen Video- oder Audiodateien mit bis zu 20 GB sein. Upload-URLs sind 6 Stunden gültig.
• Jeder Schlüssel kann 600 Anfragen pro Minute stellen und 30 Importe pro Minute starten. Eine Antwort 429 bedeutet: langsamer werden und erneut versuchen.
• Die Schlüsselliste zeigt, wann jeder Schlüssel zuletzt verwendet wurde. Revoke sperrt einen Schlüssel sofort.
• Benötigt den Standard-Tarif oder höher.

Vollständige Anleitung: API-Schlüssel.