API 2.0

[Lumpy]

Hallo zusammen,

hier die neue API für SeeKampf.de.

Pfad: https://www.seekampf.de/api/api2.php

Authentifizierung
HTTP-Header.
spielername:passwort
Account darf nicht gesperrt sein.

Durch diese Art von Authentifizierung können auch personenbezogene Daten abgerufen werden. Natürlich nur eure eigenen.
-------------------------------------------------------
Eigene Daten //Ruft eure Spielerdaten ab

Code: Alles auswählen

Link: ?server=1&typ=meinedaten

Filter: -/-

Inseln //Zeigt alle Inseln an //Serverweit

Code: Alles auswählen

Link: ?server=1&typ=inseln

Filter:
&me=true //zeigt nur eure eigenen Inseln, dafür aber detailreich. (Gebäude Stufen z.B., Gold, Stein....)
&id={id} //Zeigt euch nur diese eine Insel an (+me auch Details)
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&free=false //Wenn das so gesetzt ist werden keine herscher losen Inseln angezeigt.
Infos zu den Feldern
gebaeudewirdgebaut : true/false //Gibt zurück ob auf dieser Insel ein Gebäude ausgebaut wird.
einheitenwerdengebaut : true/false //Gibt zurück ob auf dieser Insel Einheiten ausgebildet werden.
schiffewerdengebaut : true/false //Gibt zurück ob auf dieser Insel Schiffe gebaut werden.
angriff : true/false //Gibt an ob dein Wachturm einen Angriff sieht


Spieler //Zeigt alle Spieler an

Code: Alles auswählen

Link: ?server=1&typ=spieler

Filter:
&id={id} //Zeigt einen bestimmten Spieler an
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={id,spielername,punkte,allianz,platzierung} //Sortieren der ausgabe
&filter=allianz //Zeigt mir alle Spieler aus meiner Allianz
&filter=freunde //Zeigt mir alle Spieler die meine Freunde sind
&inselnanzeigen=true //Zeigt zusätzlich in einem Inner-Array die Insel/n von dem Spieler an

Nachrichten

Code: Alles auswählen

Link: ?server=1&typ=nachrichten

Filter:
&ungelesen=true //Zeigt nur deinen eigenen "Ungelesenen" Nachrichten
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={time,von}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein
&id={Nachricht-ID} //Gibt nur diese eine Nachricht aus und setzt diese von ungelesen auf gelesen

Nachricht senden BETA //Beta weil, kein Spamschutz vorhanden. //Feedback wünschenswert

Code: Alles auswählen

Link: ?server=1&typ=nachricht_senden

Benötigt werden folgende POSTs: //Pflichtfelder
nach {spielerid}
betreff [TEXT] //Kann unformatiert bleiben, wird Serverseitig richtig formatiert.
text [TEXT] //Kann unformatiert bleiben, wird Serverseitig richtig formatiert.
FORMAT: JSON z.B.

Code: Alles auswählen

{"nach":1,"betreff":"Hallo du","text":"Testnachricht"}

Allianz

Code: Alles auswählen

Link: ?server=1&typ=allianz

Filter:
&id={} //AllianzID um nur dieser Alli anzuzeigen.
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={id,punkte}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein


Allianzforum //Zeigt alle Themen und Posts meiner Allianz an

Code: Alles auswählen

Link: ?server=1&typ=allianzforum

Filter:
&themaid={} //Zeigt nur das eine Thema an.

Allianzforumthreads //Zeigt alle Themen und Posts meiner Allianz an

Code: Alles auswählen

Link: ?server=1&typ=allianzforumthreads

Filter:
&id={threadid} //Zeigt nur diesen einen Thread an
&posts=true //Zeigt als inner Array die Posts dazu an //Kombinierbar mit ID und/oder ohne
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein

Allianzforumposts //Zeigt alle Themen und Posts meiner Allianz an

Code: Alles auswählen

Link: ?server=1&typ=allianzforumposts

Filter:
&id={} //Zeigt nur die Posts mit der passender Threadid //Pflichtfeld
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein

Schifffahrt //Zeigt deine Schiffahrten an [ALLE]

Code: Alles auswählen

Link: ?server=1&typ=schifffahrt

Filter:
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein

Berichte //Zeigt deine Berichte an [Aktuell ohne Freundesfreigabe und Allifreigabe] [ALLE]

Code: Alles auswählen

Link: ?server=1&typ=berichte

Filter:
&id={} //Mit ID bekommst du Details zu den Berichten.
&offset={}&limit={} //Limitiert die Abfrage. Offset und Limit müssen immer zusammen auftauchen (MySQL LIMIT)
&orderby={}&dir={asc,desc} //Sortieren der Ausgabe //Beide müssen vorhanden sein

Auktionen //Zeigt alle Auktionen an

Code: Alles auswählen

Link: ?server=1&typ=auktionen

Filter:
-/-
Info zu dem Feld Status:
Status=3 //Meine Auktion die ich erstellt habe
Status=2 //Ich bin hoechstbietender
Status=1 //Ich habe mit geboten, bin aber nicht hoechstbietender.
Status=0 //Nicht meine Auktion und ich habe nicht geboten

Zu ORDERBY...
Es lässt sich alles danach sortieren, was ihr zurück geliefert bekommt. Kommt z.B. ein time beim json string zurück, könnt ihr mit orderby danach sortieren.


Lumpy: Natürlich kann man noch viel viel mehr auslesen, aber das sollte erstmal reichen. Mehr Daten?? Bitte PN an mich!

[Lumpy]

Update 1.1.
siehe oben

[Lumpy]

Update 1.2

[Lumpy]

Update 1.3

[Lumpy]

Update 1.4

[Lumpy]

Update 1.5

Schifffahrt hinzugefügt.

[Lumpy]

Update 1.6

Berichte hinzugefügt.

[Lumpy]

API für Server 3 freigeschaltet... Könnte noch Probleme machen.