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 = "{var url}/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.