Für einen sicheren Internetzugang ist eine kurze Anpassung notwendig.
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 S.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-Version: 1.0
API-Endpoint: https://s.to/api/{version}/
Der API-Key kann beim Support beantragt werden und ist immer als URL-Parameter key zu ubergeben:
https://s.to/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.
API-Keys werden fur den nötigen Zweck ausgestellt und dementsprechend in folgenden Aspekten beschränkt:
Meldet einen Nutzer an und setzt ein Session-Cookie (SSTOCDN). Der SESSION-Cookie muss bei allen Accountseitigen-Anfragen mitgesendet werden.
AufrufPOST /api/v1/account/login
Antwort{ "success":true }Parameter
Wert | Beispiel | Beschreibung |
---|---|---|
user@example.com | E-Mail Adresse des Nutzers | |
password | uPass123 | Passwort des Nutzers |
Gibt die Serien der Watchlist des Nutzers aus.
AufrufGET /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 |
Fügt der Watchlist einen Eintrag hinzu.
AufrufPOST /api/v1/account/watchlist/add
Antwort{ "success":true }Parameter
Wert | Beispiel | Beschreibung |
---|---|---|
id | 25 | hinzuzufügende Serie (id) |
Fügt der Watchlist einen Eintrag hinzu.
AufrufPOST /api/v1/account/watchlist/remove
Antwort{ "success":true }Parameter
Wert | Beispiel | Beschreibung |
---|---|---|
wid | 25 | zu entfernender Watchlist-Eintrag (wid) |
Fügt der Watchlist einen Eintrag hinzu.
AufrufGET /api/v1/genres/list
Antwort{ "genres":[ { "id":1, "name":"Abenteuer", "link":"abenteuer" }, { "id":2, "name":"Action", "link":"action" } //, ... ] }Parameter
keine Parameter
Trägt einen Link ein. Diese Funktion ist aufgrund von fairness deaktiviert.
AufrufPOST /api/v1/links/submit
Antwort{ "success":true }Parameter
Wert | Beispiel | Beschreibung |
---|---|---|
series | 25 | Serien-ID |
season | 1 | Staffel |
episode | 1 | Episode |
language | 1 | Sprache
|
link | http://link/id | einzutragender Link |
Liefert eine Liste der Serien.
AufrufGET /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:
|
genre | 1 | (optional, schließt category aus) Genre-ID siehe /v1/genres/list |
Liefert Informationen zu einer Serie, Staffel oder Episode.
AufrufGET /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://s.to/goto/idAtHoster", "hoster":"HosterName", "language":1 } //, ... ] } //, ... ] }Parameter
Wert | Beispiel | Beschreibung |
---|---|---|
series | 25 | Serien-ID |
season | 1 | Staffel (optional) |
{ "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 ] }
Liefert die aktuelle Statistik.
AufrufGET /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