API DOKU

Die API ist unter folgender URL zu finden:

http://mediadb.ivaya.de/api.php?key={%KEY%}&action={%Action%}

Der API Key {%KEY%}

Der API KEY ist eine zufällig generierte Zeichenfolge aus Buchstaben (a-z, A-Z) und Zahlen (0-9). Zurzeit gibt es keine Möglichkeit API-Keys zu Generieren aber folgende Keys sind verfügbar:

Key	Rechte
0123456789	nur lese Rechte
SCHLUESSEL	nur lese Rechte
SCHLUESSEW	lesen und setzen Rechte (lesen/schreiben)
SCHLUESSEA	alle Rechte (lesen/schreiben)

Die Antwort vom Server (JSON)

{ "API_VERSION": 0.001, "API_KEY": "0123456789", "API_Laufzeit": "0.00017", "Antwort": { [%ACTION% - Abhängige Antwort] } }

API_VERSION - Die Version der API
API_KEY - der Verwendete API_KEY
API_Laufzeit -Die Laufzeit der API

Die verfügbaren Actions {%Action%}, und deren Antwort

Respons auf `api.php?key={%key%}&action=serverinfo`

{ "API_VERSION": 0.001, "API_KEY": "0123456789", "API_Laufzeit": "0.00009", "Antwort": { "time": 1452585836, "HTTP_USER_AGENT": "Mozilla\/5.0 (Windows NT 6.3; WOW64; rv:43.0) Gecko\/20100101 Firefox\/43.0", "REMOTE_ADDR": "195.37.187.27" } }

Respons auf `api.php?key={%key%}&action=GetDataList`

Dieser Aufruf hat folgende Zusätzliche Parameter:

mediadb.ivaya.de/api.php?key={%KEY%}&action={%action%}&Tabelle={%Tabelle%}
[&Spalten={%Spalten%}]
[&Sortierung={%Sortierung%}]
[&Anzahl={%Anzahl%}]
[&imdbID={%imdbID%}]
[&Suche={%Suche%}]
[&3d={%3d%}]
&GenreID={%GenreID%}] ODER [&Genre={%Genre%}
&SchauspielerID={%SchauspielerID%}] ODER [&Schauspieler={%Schauspieler%}
[&Englisch={%Englisch%}]
[&Deutsch={%Deutsch%}]
[&acodecger={%acodecger%}]
[&acodeceng={%acodeceng%}]
[&vcodec={%vcodec%}]
[&resolution={%resolution%}]
[&channelsger={%channelsger%}]
[&channelseng={%channelseng%}]
[&hdd={%hdd%}]
[&checked={%checked%}]
[&Jahr={%%}]
[&Groesse={%Groesse%}]
[&Laufzeit={%Laufzeit%}]
[&Hinzugefuegt={%Hinzugefuegt%}]
[&Gesehen={%Gesehen%}]
[&Youtube={%youtbe%}]
[&series_nr={%series_nr%}]
[&series_nr={%series_nr%}]

Allgemeine Parameter:

{%Tabelle%} Mysql Tabelle die genutzt werden soll.

Für alle {%Tabelle%}:

({%Spalten%} z.b. imdbID,name,duration)
({%Sortierung%} z.b. name)
({%Anzahl%} z.b. 2)

Für {%Tabelle%} = Filme:

({%imdb%} z.b. 0053285)
({%Suche%} z.b. 2012 oder Bildfehler)
({%3d%} z.b. 0 oder 1)
({%GenreID%} z.b. 1,2)*
({%Genre%} z.b. Fantasy,Musical)*
({%SchauspielerID%} z.b. 1,2)*
({%Schauspieler%} z.b. Brad Pitt,Nicolas)*
({%Englisch%} z.b. 0 oder 1)
({%Deutsch%} z.b. 0 oder 1)
({%DeutschCodec%} z.b. Vorbis)
({%acodeceng%} z.b. Vorbis)
({%vcodec%})
({%resolution%})
({%channelsger%})
({%channelseng%})
({%hdd%})
({%checked%})
({%youtube%} z.b. DE EN 0 oder 1)

Für {%Tabelle%} = Staffeln

({%series_nr%})

Für {%Tabelle%} = Episoden

({%series_nr%})
({%season_nr%})

*UND Verknüpft bei mehreren die Komma Separiert sind

Respons auf: api.php?key={%key%}&action=GetDataListe&Tabelle=Filme&Spalten=imdbID,name,duration&Sortierung=name&Anzahl=2

{ "API_VERSION": 0.001, "API_KEY": "0123456789", "API_Laufzeit": "0.00129", "Antwort": { "Spalten": [ "imdbID", "name", "duration" ], "Data": [ { "imdbID": "1715873", "name": "10 Jahre - Zauber eines Wiedersehens", "duration": "6000" }, { "imdbID": "1542344", "name": "127 Hours", "duration": "5580" } ] } }

Respons auf `api.php?key={%key%}&action=SetData&Tabelle=Filme`

imdbID={%imdbID%}&3d=[&Gesehen=ja][&checked=0][&comment=Bildfehler] 1 von 3 muss gesetzt werden..

Fehler Antwort:

{ "API_VERSION": 0.001, "API_KEY": "0123456789", "API_Laufzeit": "0.00012", "Antwort": { "FehlerID": 1003, "FehlerText": "Die gew\u00fcnschte 'action' serverinfoasdf exisitiert nicht!" } }

Home