Schnittstellen-API

Aus Feuerwache.net Anleitung
Wechseln zu: Navigation, Suche

Feuerwache.net ist eine Erfolgsgeschichte und begeistert tausende von Spielern. Feuerwache.net wird dabei ständig nach den Wünschen der Spieler weiterentwickelt, doch einigen Spielern ist das einfache Vorschlagen von neuen Funktionen zu wenig. Sie wollen selbst Hand anlegen. Deshalb gibt es nun diese Schnittstellen!


Schnittstelle Nr. 1: Wachen, Gebäude und Fahrzeuge

Mit Hilfe dieser Schnittstelle lassen sich Informationen über Wachen, Gebäude und Fahrzeuge gewinnen. Die Schnittstelle stellt dem Benutzer eine Liste der Wachen mit Informationen über die Position der Wachen, Anzahl Stellplätze, Anzahl der Feuerwehrleute, Ausbaustufe der Wachen, an den Wachen stationierten Fahrzeugen mit deren FMS-Status und Zustand sowie eine Liste der Gebäude mit Infos über deren Position und Typ u.v.m. zu Verfügung.

POST/GET-Request

Adresse: http://www.feuerwache.net/feuerwache/xmlList
Felder: username=[Benutzername]&password=[Benutzerpasswort]

Response:
Als Antwort bekommt man ein XML-Dokument zurück. Wichtig: Das Dokument hat zwei Stammelemente. Manche XML-Parser haben damit Probleme. Hier muss jedes Stammelement für sich einzelnd geparst werden.

Stammelement 1: <feuerwaches>

Beispiel

   <feuerwaches>
<feuerwache>
<position_x>49</position_x>
<position_y>51</position_y>
<caption>Feuerwache</caption>
<vehicle_max>2</vehicle_max>
<vehicle_current>2</vehicle_current>
<rtw_max>0</rtw_max>
<rtw_current>0</rtw_current>
<level>2</level>
<personal_current>24</personal_current>
<vehicle_to_users>
<vehicle_to_user>
<caption>Drehleiter Nummer eins</caption>
<state>93</state>
<fms>2</fms>
<type>DLA (K) 23/12</type>
<person_current>0</person_current>
</vehicle_to_user>
<vehicle_to_user>
<caption>mein lieblings GW-A</caption>
<state>100</state>
<fms>2</fms>
<type>GW-A</type>
<person_current>0</person_current>
</vehicle_to_user>
</vehicle_to_users>
</feuerwache>
<feuerwache>
...
</feuerwache>
</feuerwaches>

Feldererklärung

<position_x> X-Koordinate der Position der Wache auf der Karte
<position_y> Y-Koordinate der Position der Wache auf der Karte
<caption> Name der Wache
<vehicle_max> Anzahl Fahrzeugstellplätze (außer RTW)
<vehicle_current> Anzahl Fahrzeugstellplätze (außer RTW)
<rtw_max> Anzahl der RTW-Stellplätze an der Wache
<rtw_current> Anzahl der RTWs an der Wache
<personal_current> Personal der Wache
<vehicle_to_users> Auflistung der Fahrzeuge der Wache, als parent-Element für mehrere <a href="#vehicle_to_user"><vehicle_to_user>-Elemente</a>
<level> Ausbaustuffe der Wache


<vehicle_to_user>-Element:

<caption> Name des Fahrzeugs
<state> Zustand des Fahrzeugs
<fms> FMS-STatus des Fahrzeugs
<type> Type des Fahrzeugs
<person_current> Aktuelle Besetzung des Fahrzeugs (wenn nicht ausgrückt natürlich 0)




Stammelement 2: <building_to_users>

Beispiel

  <building_to_users>
<building_to_user>
<position_x>87</position_x>
<position_y>5</position_y>
<caption>Feuerwehrschule Nr. 1</caption>
<building_type>1</building_type>
</building_to_user>
</building_to_user>
...
</building_to_user>
</building_to_users>

Feldererklärung

<position_x> X-Koordinate der Position des Gebäudes auf der Karte
<position_y> Y-Koordinate der Position des Gebäudes auf der Karte
<caption> Name des Gebäudes
<building_type> Typ des Gebäudes (1 = Schule, 2 = Krankenhaus, 3 = Werkstatt)


Programme und Skripte die diese Schnittstelle nutzen

  • Map zur besseren Fahrzeugübersicht


Schnittstelle Nr. 2: Aktuelle Einsätze

Über diese Schnittstelle lassen sich Informationen über die aktuell vorliegenden Einsätze eines Spieler abfragen. Hierzu muss ein POST-Request an die unten angegebene Webadresse gesendet werden und dabei der Benutzername als Inhalt des Feldes "username" und das Passwort als Inhalt des Feldes "password" übergeben werden.


POST/GET-Request

Adresse: http://www.feuerwache.net/mission_to_user/xmlList/
Felder: username=[Benutzername]&password=[Benutzerpasswort]

Response:
Als Antwort gibt der Server ein XML-Dokument zurück in dem Informationen über Position und Name des Einsatzes sowie seines Status angegeben sind.

Beispiel:

  <mission_to_users>
<mission_to_user>
<position_x>96</position_x>
<position_y>38</position_y>
<mission_to_user_id>79987057</mission_to_user_id>
<mission_caption>Wohnblockbrand</mission_caption>
<icon>lightning_red.png</icon>
</mission_to_user>
<mission_to_user>
...
</mission_to_user>
</mission_to_users>

Feldererklärung

<position_x> X-Koordinate der Position des Einsatzes auf der Karte
<position_y> Y-Koordinate der Position des Einsatzes auf der Karte
<mission_to_user_id> ID des Einsatzes (z.B. zum Aufruf der Einsatzseite: http://www.feuerwache.net/feuerwehr-einsaetze/[Einsatz-ID])
<mission_caption> Bezeichnung des Einsatzes
<icon> Dateiname des aktuellen Einsatzstatussymbols (lightning.png = neu; lightning_red.png = neu, ausgebreitet; bell.png = wartet auf Einsatzkräfte; bell_red.png = wartet, ausgebreitet; error.png = Nachforderung; pill.png = wartet auf RTW)


Programme und Skripte die diese Schnittstelle nutzen