API Dokumentation

1. GRUNDLEGENDES

1.1 ZUGRIFF

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.to 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-Endpoint: https://serienstream.to/api/{version}/

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

https://serienstream.to/api/{version}/function?key=MYSECRETKEY

Jeder Key kann unterschiedliche Berechtigungen und Beschränkungen haben, diese konnen beim Support erfragt werden.

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).

Aufruf

POST /api/v1/account/login

Antwort
{  
   "success":true
}
Parameter
Wert Beispiel Beschreibung
email user@example.com 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":"https://serienstream.to/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 /api/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