API Dokumentation

Wir sind im Moment auf der Suche nach weiteren Entwicklern, welche die Entwicklung unserer Android-App (Kotlin) etwas weiterführen möchten.
Falls du Erfahrung, Zeit & Lust hast, melde dich bei Reddington.

Leider ist das Team im Moment vollständig ausgelastet und kann deswegen die App nicht weiter aktualisieren (Neue Hoster integrieren, Kompatibilität erhöhen, Support Library gegen AndroidX auswechseln, ...).

Wir bieten Entwicklern die Möglichkeit über eine API eigene Anwendungen wie
z.B. eine Android App oder ein Plugin für Multimedia-Player mit serienstream.cc zu verbinden.
Für die API wird ein API-Key zur Authentifizierung benötigt, dieser kann
beim Support Team erfragt werden. Erstelle dazu ein Support Ticket mit einer
kurzen Beschreibung deiner Anwendung. Nachfolgend findest du die Dokumentation.

API-Version: 1.0

1. GRUNDLEGENDES

1.1 ZUGRIFF

API-Endpoint: http://www.serienstream.cc:80/api/{version}/

Der API-Key kann beim Support beantragt werden und ist immer als URL-Parameter key zu ubergeben:

http://www.serienstream.cc:80/api/{version}/function?key=MYSECRETKEY

Jeder Key kann unterschiedliche Berechtigungen und Beschränkungen haben, diese konnen beim Support erfragt werden bzw. sind in der Key-Übersicht ersichtlich.

1.2 Beschränkungen

API-Keys werden fur den nötigen Zweck ausgestellt und dementsprechend in folgenden Aspekten beschränkt:

  • Abfrage-Anzahl in 24 Stunden
  • Abfrage-Anzahl bestimmter Funktionen
  • Zugriffsbeschränkungen anhand von IP, User-Agent, ...
  • erlaubte Funktionen
  • Inhalte der Antworten

2 Funktionen

2.1 /v1/account/login

Meldet einen Nutzer an und setzt ein Session-Cookie (SSTOCDN). Der SESSION-Cookie muss bei allen Accountseitigen-Anfragen mitgesendet werden.

Aufruf

POST /api/v1/account/login

Antwort
{  
   "success":true
}
Parameter
Wert Beispiel Beschreibung
email [email protected] E-Mail Adresse des Nutzers
password uPass123 Passwort des Nutzers

2.2 /v1/account/watchlist/list

Gibt die Serien der Watchlist des Nutzers aus.

Aufruf

GET /api/v1/account/watchlist/list

Antwort
{  
   "series":[  
      {  
         "wid":1,
         // Watchlist-ID "id":1,
         "name":"Eine Serie",
         "link":"eine-serie",
         "cover":"/full/path/to/cover.jpg",
         "background":"/full/path/to/bg.jpg",
         "description":"Serienbeschreibung ...",
         "trailer":"http://external.page/video",
         "fsk":"12"
      }      //,
      ...
   ]
}
                
Parameter
Wert Beispiel Beschreibung
extended 1 (optional) zusätzliche Informationen: cover,background,description,trailer,fsk

2.3 /v1/account/watchlist/add

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

POST /api/v1/account/watchlist/add

Antwort
{  
   "success":true
}
                
Parameter
Wert Beispiel Beschreibung
id 25 hinzuzufügende Serie (id)

2.4 /v1/account/watchlist/remove

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

POST /api/v1/account/watchlist/remove

Antwort
{  
   "success":true
}
                
Parameter
Wert Beispiel Beschreibung
wid 25 zu entfernender Watchlist-Eintrag (wid)

2.5 GET /v1/genres/list

Fügt der Watchlist einen Eintrag hinzu.

Aufruf

GET /api/v1/genres/list

Antwort
{  
   "genres":[  
      {  
         "id":1,
         "name":"Abenteuer",
         "link":"abenteuer"
      },
      {  
         "id":2,
         "name":"Action",
         "link":"action"
      }      //,
      ...
   ]
}
                
Parameter

keine Parameter

2.6 /v1/links/submit

Trägt einen Link ein. Diese Funktion ist aufgrund von fairness deaktiviert.

Aufruf

POST /api/v1/links/submit

Antwort
{  
   "success":true
}
                
Parameter
Wert Beispiel Beschreibung
series 25 Serien-ID
season 1 Staffel
episode 1 Episode
language 1 Sprache
  • 1 = Deutsch
  • 2 = Englisch
  • 3 = Ger-Sub
link http://link/id einzutragender Link

2.7 /v1/series/list

Liefert eine Liste der Serien.

Aufruf

GET /api/v1/series/list?extended=1&category=1

Antwort
{  
   "series":[  
      {  
         "id":1,
         "name":"Eine Serie",
         "link":"eine-serie",
         "cover":"/full/path/to/cover.jpg",
         "background":"/full/path/to/bg.jpg",
         "description":"Serienbeschreibung ...",
         "trailer":"http://external.page/video",
         "fsk":12
      }      //,
      ...
   ]
}
                
Parameter
Wert Beispiel Beschreibung
extended 1 (optional) zusätzliche Informationen: cover,background,description,trailer,fsk
category 1 (optional) zeigt nur Serien der Kategorie:
  • 0 = alle Serien
  • 1 = Beliebt
  • 2 = Neu
  • 3 = Top
  • 4 = zuletzt gesehen
genre 1 (optional, schließt category aus) Genre-ID siehe /v1/genres/list

2.8 /v1/series/get

Liefert Informationen zu einer Serie, Staffel oder Episode.

Aufruf

GET /api/v1/series/get?series=25&season=1

Antwort (Staffel)
{  
   "series":{  
      /* ... */
   }   "episodes":[  
      {  
         "series":25,
         "season":1,
         "episode":1,
         "german":"Folge Eins",
         "english":"Episode one",
         "description":"Lange Episodenbeschreibung ...",
         "links":[  
            {  
               "id":123456,
               "link":"http://www.serienstream.cc:80/goto/idAtHoster",
               "hoster":"HosterName",
               "language":1
            }            //,
            ...
         ]
      }      //,
      ...
   ]
}
                
Parameter
Wert Beispiel Beschreibung
series 25 Serien-ID
season 1 Staffel (optional)
Antwort (Serie)
{  
   "series":{  
      "id":25,
      "name":"Meine Serie",
      "link":"meine-serie",
      "cover":"/full/path/to/cover.jpg",
      "background":"/full/path/to/background.jpg",
      "trailer":"http://external.page/video",
      "fsk":12,
      "description":"Lange Beschreibung der Serie...",
      "productionStart":2006,
      "productionEnd":2011,
      "rating":{  
         "count":123,
         "result":4.5
      },
      "mainGenre":{  
         "id":2,
         "name":"Action",
         "link":"action"
      },
      "otherGenres":[  
         /* ... */
      ],
      "directors":[  
         {  
            "name":"Jim Doe",
            "link":"jim-doe"
         }         //,
         ...
      ],
      "actors":[  
         {  
            "name":"Bob Doe",
            "link":"bob-doe"
         }         //,
         ...
      ],
      "countries":[  
         {  
            "name":"USA",
            "link":"usa"
         }         //,
         ...
      ],
      "watchlist":false,
      "favourite":false
   },
   "seasons":[  
      1,
      2,
      3
   ]
}
                

2.9 /v1/statistics/get

Liefert die aktuelle Statistik.

Aufruf

GET /api/v1/statistics/get

Antwort
{  
   "links_count":1300000,
   "series_count":1500,
   "episodes_count":130000,
   "user_count":1300,
   "user_online":100,
   "user_online_list":[  
      {  
         "username":"Bob",
         "userlink":"bob",
         "rank":"user"
      }      //,
      ...
   ],
   "latest_user":"Jim"
}
                
Parameter

Keine Paramter