HIGHWAY API

Hallo,

wie viele sicherlich wissen nutzen die meisten Downloadmanager unsere API zum herunterladen der Dateien. Damit High-Way auf möglichst vielen Geräten und Programmen funktioniert, möchte ich euch hier unsere aktuelle API Dokumentation vorstellen.

Postman Doku: https://documenter.getpostman.com/view/5631083/UVCBBk82

User-API:
URL: https://high-way.me/apiV2.php

Parameter:

• hoster: Gibt eine Liste der Hoster aus. (GET)
• user: Gibt die Informationen zum User aus. (GET)
• logincheck: Gibt zurück, ob der User eingeloggt ist oder nicht (GET)
• login: Führt einen Login durch. user und pass werden dann benötigt. (GET)
  • user: Benutzername (Nur als POST)
  • pass: Passwort (Nur als POST)

Die Paramater können kombiniert werden:
z.B.: https://high-way.me/apiV2.php?hoster&user Gibt Informationen zum User und eine Liste der Hoster aus.

Der Login wird für die Session im Cookie PHPSESSID gespeichert.

Antworten:
Alle Antworten der API sind im JSON Format.

z.B.:
Hoster:

Code:

{
  "loggedin": true,
  "premium": true,
  "hoster": [
    {
      "name": "1fichier.com",
      "active": "1",
      "chunks": "1",
      "downloads": "1",
      "resume": "1",
      "berechnung": "33",
      "rabatt": "33",
      "linkwildcards": "",
      "maxTrafficDaily": -1,
      "usedTrafficDaily": -1,
      "remainingTrafficDaily": -1
    },
    {
      "name": "turbobit.net",
      "active": "1",
      "chunks": "4",
      "downloads": "4",
      "resume": "1",
      "berechnung": "200",
      "rabatt": "200",
      "linkwildcards": "",
      "maxTrafficDaily": 60000000000,
      "usedTrafficDaily": 45456164 ,
      "remainingTrafficDaily": 55454354355
    },
    {
      "name": "uploaded.net",
      "active": "1",
      "chunks": "4",
      "downloads": "4",
      "resume": "1",
      "berechnung": "100",
      "rabatt": "100",
      "linkwildcards": "*:\/\/uploaded.net\/file\/*|*:\/\/uploaded.to\/file\/*|*:\/\/ul.to\/*",
      "maxTrafficDaily": 225000000000,
      "usedTrafficDaily": 0,
      "remainingTrafficDaily": 225000000000
    }
  ]
}

• name: Name des Hosters
• active: Die 1 bzw. 0 steht für funktionstüchtig oder nicht.
• unlimited: Wenn dort eine 1 ist wird nur 50% des Traffics abgezogen.
• chunks: Die maximale Anzahl an Chunks
• downloads: Die maximale Anzahl aktiver Downloads
• resume: Ob das Resume möglich ist.
• berechnung: Prozentwert zu dem der Traffic berechnet wird.
• maxTrafficDaily: Maximaler täglicher Traffic
• usedTrafficDaily: Genutzer täglicher Traffic.
• remainingTrafficDaily: Verbleibender täglicher Traffic.

User:

Code:

{
  "loggedin": true,
  "user": {
    "id": "2",
    "premium_traffic": 1254266142820,
    "premium_max": 1310000000000,
    "premium_bis": 2147483647,
    "free_traffic": 5000000000,
    "remain_free_traffic": 5000000000,
    "max_connection": 10,
    "max_chunks": 4,
    "resume": 1,
    "usenet": {
      "username": "Yaknar",
      "pass": "s11fkdnxrns129pr"
    },
    "premium": 1
  },
  "premium": true,
}

• premium_traffic: Wenn der Nutzer Premium ist, dann stehen dort die verbleibenden Bytes.
• premium_max: Das maximale Traffic, in Bytes.
• premium_bis: Unixtime, bis wann der Account maximal gültig ist.
• free_traffic: Das maximale free Traffic pro Tag
• remain_free_traffic: Die Anzahl an Traffic die einem free User noch zur Verfügung steht. (Entweder Limitiert durch die Coins oder der 5GB Grenze)
• max_connection: Maximale Anzahl gleichzeitiger Verbindungen.
• max_chunks: Maximale Anzahl an Chunks.
• usenet: Array mit Usenet Zugangsdaten.
• resume: Fortsetzen möglich oder nicht.
• premium: 1= Premium, 0= free User.

premium_traffic,premium_max,premium_bis sind NULL, wenn der User nicht Premium ist.

Fehler:

• [] = Keine Parameter gesetzt.
• {"error":"NotLoggedIn"} = User nicht Eingeloggt, dann mit dem Parameter login, user und pass einloggen.
• {"error":"UserOrPassInvalid"} = Benutzername/E-Mail oder Passwort falsch.
• {"error":"RecordingNotAccepted","msg":"Recorder nicht aktiviert"} = TV Recorder nicht aktiviert.
• {"error":"ServerFailure","msg":"XXX"} = Fehler bei HW. Detail in msg z.B.: Datenbank nicht erreichbar

Download-API:

URL: https://high-way.me/load.php

Parameter:

• link=https%3A%2F%2F1fichier.com%2F%3Fjjktgmiksb (Der herunterzuladende Link + Urlencode, als GET oder POST)
• json (Ohne diesen Parameter ist es XML)
  
• Entweder die Cookies von Login aus der api.php oder mit "login" einloggen:
• login: Führt einen Login durch. user und pass werden dann benötigt. (GET oder POST)
  • user: Benutzername (Nur als POST)
  • pass: Passwort (Nur als POST)
• pass: Das Passwort für den Zugriff auf die Datei beim Hoster.
  Falls die Parameter nicht gesendet wurde, aber ein Passwort benötigt wird, gibt es den Fehlercode 13.

z.B. https://high-way.me/load.php?json&link=https%3A%2F%2Frapidgator.net%2Ffile%2Fb9c2f42df27ff047054b1e5bb3904ed1

Antwort (JSON):

Code:

{
   "code":"0",
   "id":"rp4t",
   "size":"73964572",
   "sizeCa":"73966551",
   "name":"ubuntu-20-04-essentials-desktop-server.rar",
   "link":"https:\/\/rapidgator.net\/file\/b9c2f42df27ff047054b1e5bb3904ed1",
   "download":"https:\/\/srv15.dwld.link\/dl2\/rp4t\/",
   "hash":"MD5:e59fa3fcac6abd954c42562dbd83d421",
   "cache":"https:\/\/srv15.dwld.link\/cache\/rp4t\/",
   "cacheStatus":"s",
   "loggerID":"0"
}

code: Fehlercode, 0 = kein Fehler.
size: Dateigröße, muss nicht immer gesetzt sein.
name: Dateiname
link: der angeforderte Link
download: der Link unter dem die Datei über High-Way erreichbar ist.
retry_in_seconds: Sekunden nach denen es erneut probiert werden soll.

Nur für Downloads über den Cache gibt es folgende zusätzliche Parameter:
id: ID des Downloads, welche auch in der URL verwendet wird.
sizeCa: Dateigröße über Screenreader eingelesen. Ist fast immer gesetzt, aber ungenau.
hash: Hash der Datei, beginnt mit verwendetem Algorithmus.
cache: Info Seite, über die der Cache Status und verbleibende Zeit abgefragt werden kann
cacheStatus: Siehe Cache Status

Fehlercodes:
z.b.: {"code":"10","error":"Der Hoster wird nicht unterstuetzt"}

Hier die genauen Codes (Aber im Error-Tag steht auch immer die Meldung):
Fehlercode 1:
Benutzername oder Passwort falsch.

Fehlercode 2:
Bitte logge dich erneut ein.

Fehlercode 3:
Es ist nicht genügend (Premium-)Traffic vorhanden.

Fehlercode 4:
Du führst zu viele gleichzeitige Downloads aus.

Error Code 5:
Dein Premium Paket ist abgelaufen.

Fehlercode 6:
Es wurde kein oder kein gültiger Link angegeben.

Fehlercode 8:
Temporärer Fehler... Versuche es in ein paar Minuten erneut!

Fehlercode 9:
Die angegebene Datei wurde nicht gefunden.

Fehlercode 10:
Der Hoster wird nicht unterstützt / Für Free User nicht unterstützt.

Fehlercode 11:
Der Hoster führt gerade Wartungsarbeiten durch oder ist nicht erreichbar.

Fehlercode 12:
Wir führen gerade Wartungarbeiten durch.

Fehlercode 13:
Passwort benötigt(siehe Parameter Pass), falsches Passwort, wenn ein Passwort gesendet wurde oder Download ist aufgrund von Zusatz Subscriptions nicht möglich-

Fehlercode 14:
Dein hosterspezifisches Traffic-Limit wurde erreicht.
Das Limit von limitierten Hoster (wie k2s oder Nitroflare) wurde aufgebraucht.

Fehlercode 15:
Dein hosterspezifisches Request Traffic-Limit wurde erreicht.
Das Limit von limitierten Hoster (wie k2s oder Nitroflare) wurde durch Anfragen überschritten, es können dann nur noch bereits angefragte Link heruntergeladen werden. Dies ist notwendig, um nicht unnötig Traffic unserer Hoster Accounts zu verbrauchen.

Fehlercode 16:
Fehler... Kontaktiere den Support!
Allgemeiner Fehler, kontaktiere den Support für weitere Informationen bzw. Behebung des Fehlers.

Download:
Der Download findet dann über den vorher erstellten Link statt:
z.B.: http://srv4.high-way.me/dl/n4vr/100MB.rar

Cache Status:

Code:

{
   "status":"success",
   "cacheStatus":"d",
   "retry_in_seconds":5,
   "percentage_Complete":99,
   "progress_in_bytes":"73224926/73964572",
   "for_jd":"(73224926/73964572) 99% Please Wait 5 Sec (d)",
   "link":"https://srv15.dwld.link/dl2/rp4t/"
}

cacheStatus: Status des Downloads

• d: Download
• w: Warten (Auf neuen Verusuch)
• q: In der Warteschlange
• qn: Download wurde der Warteschlange hinzugefügt.
• s: Download ist fertig.
• i: Direkter Download ohne Cache

retry_in_seconds: Wann soll es erneut probiert werden
percentage_Complete: Prozentualer Fortschritt.
progress_in_bytes: Fortschritt in Bytes.
for_jd: Meldung die der jDownloader anzeigen soll.
link: Download Link


TV-Recorder API:

Endpoint: https://high-way.me/apitv/

Login:
Siehe User-API

TV Stations:
Parameter:
GET:
tvstation

GET https://high-way.me/apitv/tvstation
[{
"id":1,
"LogoUrl":"https:\/\/high-way.me\/tvr\/images\/tvstations\/40x21\/1.png",
"name":"Das Erste"},
....

Suche:
Parameter:
GET:
search (required, can be empty) Search String z.B. Tartort
zeit Zeit in Blöcken: 1 = 06-12 Uhr, 2 = 12-18 Uhr, 3 = 18-24 Uhr, 4 = 00-06 Uhr
senderid Sender ID from 'TV Stations', separate multiple by ,
addfree Nur Werbefreie Aufnahmen
page Ausgewählte Seite. Start bei 1

z.B.: Alle werbefreien Aufnahmen von "Das Erste" von 06-12 Uhr, Seite 1
GET https://high-way.me/apitv/search?search=&senderid=1&zeit=1&search=&page=1&addfree
{"result":[{
"telecastid":"13787884",
"quelle_id":"1",
"StartDate":"2017-06-13 19:00:00",
"EndDate":"2017-06-13 19:45:00",
"LogoUrl":"https:\/\/high-way.me\/tvr\/MediaServer\/cache\/x134y83\/2\/4\/242788_2BF2AF6A5B14307F0EC85978283B6913.jpg",
"title":"In aller Freundschaft",
"subtitle":"Mach's gut, Nick",
"StationName":"Das Erste"},
....

Download/Stream:
Parameter:
GET:
id = telecastid der Suche
quelle_id = quelle_id der Suche
Optional:
format = Format der Suche. 4 = HQ, 5 = HD. Ohne wird das beste Format verwendet.
adfree = 1=Werbefrei. Ohne wird die Werbefreie Version verwendet, wenn verfügbar.

z.B.
https://high-way.me/apitv/dl?id=13787884&quelle_id=1

{"code":"0",
"size":"528977628",
"name":"2017-06-13+19%3A00%3A00_Das+Erste_In+aller+Freundschaft+Mach%27s+gut%2C+Nick+H.264+High+Quality+%28Werbefrei%29.mp4",
"stream":"https%3A%2F%2Fhigh-way.me%2Fstreamtv%2Ffau%2F",
"download":"http%3A%2F%2Fsrv12.high-way.me%2Fdltv%2Ffau%2F2017-06-13+19%3A00%3A00_Das+Erste_In+aller+Freundschaft+Mach%27s+gut%2C+Nick+H.264+High+Quality+%28Werbefrei%29.mp4"}

Download/Stream von (urldecode(download)): http://srv12.high-way.me/dltv/fau/2017-06-13 19:00:00_Das Erste_In aller Freundschaft Mach's gut, Nick H.264 High Quality (Werbefrei).mp4

Falls ihr noch Ergänzungen zur API wünscht kann ich diese in den meisten fällen gerne einfügen.

 

Changelog 24.06.2015:

Die Option "pass" und der Fehlercode 13 wurden hinzugefügt um Dateien, die vom Hoster durch ein Passwort vor dem Download geschützt sind, herunterladen zu können.

 

Changelog 12.03.2016:

Der bis jetzt nicht Dokumentierte Fehlercode 14 wurde hinzugefügt.

 

Die Zugriffe wurden auf 100 pro Minute reduziert an die api.php reduziert (Der jDownloader nutzt ca. 1 pro Minute).
Die load.php zur Link Generierung ist nicht betroffen.

Diese Änderung ist nötig, da versucht wurde Account Passwörter durch Bruteforce zu erraten.
Es wurden allerdings keine hier im Forum bekannten Benutzer getestet und es gab keine erfolgreichen Logins, aber die Limitierung soll dafür sorgen, damit solche Angriffe nicht mehr möglich sind.

Nach zu vielen Anfragen wird: 503 Service Temporarily Unavailable zurückgegeben.

Edit: Auf 100 pro Minute korrigiert.

 

Ja, das wäre auch eine Möglichkeit.
Ich wollte in dem Moment nur schnell handeln und die masse der Logins verhindern.

Jetzt kann ich natürlich soetwas einbauen und werde dich dann informieren, damit du es im jDownloader einbauen kannst.

 

Das sollte drin sein. Ich meine es wird sogar schon unterstützt, allerdings muss man einen Parameter ändern habe ich gerade nicht im Kopf, gucke ich in 5 Stunden.

Aber ich glaube es sollte auch drin sein die Head requests zu beschleunigen

 

pspzockerscene Gefunden, es funktioniert wenn du das stream weglässt und json hinzufügst.

https://high-way.me/onlinetv.php?id=13403619&quelle_id=1&format=5&adfree=0&json=1
bzw. https://high-way.me/onlinetv.php?id=13403619&quelle_id=1&format=5&adfree=0&json (json mit URL encode)
bzw. https://high-way.me/onlinetv.php?id=13403619&quelle_id=1&format=5&adfree=0 (xml artiger Kram)

 

TV Recorder API hinzugefügt.

 

API nun auch über Postman abrufbar: https://documenter.getpostman.com/view/5631083/RWgtTcZj

 

Steht sogar schon auf meiner Todo Liste. Das Problem ist, das ein XenForo Login durchgeführt wird und die SDK, die ich verwende keine 2FA unterstützt.

 

User API auf V2 aktualisiert.
Änderungen:

• Login nur mit Zugangsdaten aus dem Download Center möglich.
• Login ist auch bei aktivierter 2FA möglich, da diese für die Usenet Zugangsdaten nicht benötigt werden.
• Hosterliste enthält den maximal möglichen und noch verfügbaren täglichen Traffic.
• Download API um 2 Fehlercode erweitert
• Cache Status der API dokumentiert.

 

Für die User API ja.
Außer du hast noch etwas, was unbedingt dort mit hinein muss.

Die Änderungen der load.php sind schon etwas länger bereits so und sollte abwärtskompatibel bleiben.
Werde da aber nicht mehr viel anpassen außer das die Felder SizeCa und Hash auch demnächst nach Möglichkeit für die Hoster ohne Cache hinzufügen soll.

 

Ja, dort ist noch die alte Version beschrieben.
Passe ich noch an.

Aktuell nur die Load API.

Habe ich jetzt auch der User API hinzugefügt.

error ist die Fehlermeldung und
code der Fehler Code, wie an den anderen stellen auch.
Also:

Code:

{"code":1, "error": "Username oder Passwort ungültig"}

Ja, habe es auch nicht aktiv.
Werde ich machen.

Danke wünsche ich dir auch