API-Übersicht
Eine Übersicht der öffentlichen API-Endpunkte von OikosTV.
Basis-URL
https://dev.api.crewvid.com/api/v1/Inhalt und Entdeckung
| Methode | Endpunkt | Beschreibung |
|---|---|---|
GET | /videos/{shortUUID} | Abrufen detaillierter Informationen über ein bestimmtes Video |
GET | /channels/{handle} | Kanaldetails abrufen, einschließlich Abonnentenzahlen und Metadaten |
GET | /videos/{shortUUID}/playback | Wiedergabepaket (Manifest + Session-JWT) für ein Video erhalten |
Monetarisierung und Belohnungen
| Methode | Endpunkt | Beschreibung |
|---|---|---|
GET | /me/rewards/balance | Ihr aktuelles PeerCredits-Guthaben überprüfen |
POST | /rewards/redeem | PeerCredits gegen werbefreie Wiedergabestunden einlösen |
GET | /studio/monetization/flags | Aktivierte Monetarisierungsfunktionen für einen Kanal anzeigen |
Authentifizierung
Alle API-Anfragen müssen ein gültiges Session-Token im Authorization-Header enthalten:
http
Authorization: Bearer <session_token>Ratenbegrenzung
Um die Plattformstabilität zu gewährleisten, unterliegen alle öffentlichen Endpunkte einer Ratenbegrenzung. Bitte implementieren Sie exponentiellen Backoff für Wiederholungsversuche.
Versionierung
Wir verwenden versionierte URLs (z. B. /api/v1/...), um die Abwärtskompatibilität aufrechtzuerhalten, während sich die API weiterentwickelt. Die aktuelle stabile Version ist v1.
Fehlerantworten
Die API gibt Fehler in einem konsistenten Format zurück:
json
{
"error": "Beschreibung dessen, was schiefgelaufen ist"
}Häufige HTTP-Statuscodes:
| Code | Bedeutung |
|---|---|
400 | Schlechte Anfrage — ungültige Parameter |
401 | Nicht autorisiert — fehlendes oder ungültiges Token |
403 | Verboten — unzureichende Berechtigungen |
404 | Nicht gefunden — Ressource existiert nicht |
429 | Zu viele Anfragen — Ratenbegrenzung überschritten |
500 | Interner Serverfehler |
SDK verfügbar
Für eine einfachere Integration verwenden Sie das @crewvid/outpost-sdk-Paket, anstatt die API direkt aufzurufen.