Oil Imperium

Tools

Oil Imperium Soap Schnittstelle

Mit unserer Soap Schnittstelle könnt ihr in jeder beliebigen Programmiersprache verschiedene Daten abrufen. Dazu muss nur der WSDL File vom Server abgerufen werden.
Folgende Sachen können derzeit abgerufen werden:

Kraftstoffpreise
Welcher User ist Online
Konzern Member
Konzern Bargeld
Konzern Tanklagerinhalt
Konzern Equipment Lagerinhalt
Konzern Einnahmen durch Verträgen
Konzern Transfer (ein/aus) Geld/Rohstoffe/Equipment

Sollte Interesse an weiteren Daten bestehen so schreibt über das Supportformular an unser Developer Team und wir werden entscheiden ob wir die Daten für euch freigeben werden.
Für das Abrufen von Konzerndaten benötigt ihr einen Developercode denn werden wir auf Anfrage gern vergeben. Somit können unberechtigte Zugriffe auf Konzern interne Daten verhindert werden.

Abu Dhabi URL: http://s1.oilimperium.de/interface/oi_4players_01.wsdl

Bahrain URL: http://gamesload.oilimperium.de/interface/oi_gamesload_01.wsdl

Liste der Funktionsnamen inklusive der Ein- Ausgaben:

getOilPrice - Kraftstoffpreise

int or array getOilPrice( int $id )
@param int 0 - 3 @return int *
or
@param int 4 @return array (0 => Rohöl, 1 => Kerosin, 2 => Diesel, 3 => Benzin)
* 0 = Rohöl
* 1 = Kerosin
* 2 = Diesel
* 3 = Benzin
getUserOnline - Welcher User ist Online

array getUserOnline()
@return array (0 => Anzahl, 1 => array(0 => Name 1, 1 => Name 2) )
getCorporateGroupBalance - Konzern Bargeld

int getCorporateGroupBalance( int $kid, string $code )
@param int (Konzern ID)
@param string (Passwort)
@return int
getCorporateGroupLevel - Konzern Tanklagerinhalt

array getCorporateGroupLevel( int $kid, string $code, int $typ )
@param int (Konzern ID)
@param string (Passwort)
@param int 0 - 3 @return int *
or
@param int 4 @return array (0 => Rohöl, 1 => Kerosin, 2 => Diesel, 3 => Benzin)
* 0 = Rohöl
* 1 = Kerosin
* 2 = Diesel
* 3 = Benzin
getCorporateGroupStock - Konzern Equipment Lagerinhalt

array getCorporateGroupStock( int $kid, string $code, int $typ )
@param int (Konzern ID)
@param string (Passwort)
@param int 0 - 8 @return int *
or
@param int 9 @return array (0 => Bohrturm A, 1 => Tank A, 2 => Pipeline A, usw. )
* 0 = Bohrturm A
* 1 = Tank A
* 2 = Pipeline A
* 3 = Bohrturm B
* 4 = Tank B
* 5 = Pipeline B
* 6 = Bohrturm C
* 7 = Tank C
* 8 = Pipeline C
getCorporateGroupContractsIn - Konzerneinnahmen durch Verträgen

array getCorporateGroupContractsIn( int $kid, string $code, int $time )
@param int (Konzern ID)
@param string (Passwort)
@param int (TIMESTAMP)
@return array (array( 0 => VertragsId, 1 => "Umsatz"),
array(0 => VertragsId, 1 => "Umsatz"), usw.)
getCorporateGroupMember - Konzernmitglieder als Name oder als Anzahl

array getCorporateGroupMember( int $kid, string $code, bool $typ )
@param int (Konzern ID)
@param string (Passwort)
@param bool (false) @return int
or
@param bool (true) @return array (0 => Name 1, 1 => Name 2)
getCorporateGroupTransfer - Konzern Transfer (ein/aus) Geld/Rohstoffe/Equipment

array getCorporateGroupTransfer( int $kid, string $code, int $io, int $typ, int $time )
@param int (Konzern ID)
@param string (Passwort)
@param int (Ein- Ausgang) *
@param int (Geld/Rohstoffe/Equipment)**
@param int (TIMESTAMP)
@return array
* 1 = Eingang
* 2 = Ausgang
** 1 = Geld
** 2 = Equipment
** 3 = Kraftstoff

Es gibt verschiedene Wege die Informationen zu verarbeiten. Hier nun ein kleines Beispiel für PHP.

Beispiel:

Starten der Soap Klasse von PHP und aufruf einer Funktion

<?php

# Variablen

$debug = true; # Anzeigen von Debuginformationen

$oi_kid = 0815; # Deine Konzern ID bei Oilimperium

$oi_code = "foobar"; # Dein Developer Code bei Oilimperium

$wsdl_uri = "https://www.oilimperium.de/interface/oi_{var game_name}.wsdl";
Pfad zur Oil Imperium WSDL Datei

# PHP Errors aktivieren

if( $debug == true )

{

error_reporting(E_ALL);

ini_set("display_errors","on");

}

else

error_reporting(0);

# Soap Cache ausschalten

ini_set("soap.wsdl_cache_enabled", 0);

# Verbindung zum Oilimperium Server

$soap = new SoapClient($wsdl_uri, array("trace" => 1));

# Anzeige aller verfügbaren Funktionen

if( $debug == true )

{

$func = $soap->__getFunctions();

print_r($func);

}

# Aufruf einer Soap Funktion

$benzin_preis = $soap->getOilPrice(4);

echo $benzin_preis;
?>

Hier findet ihr noch ein kleines Beispiel als Download.