Oil Empire


Tools

Oil Empire Soap Interface

With our Soap interface you can access various data in any programming language. All you have to do is retrieve the WSDL file from the server.
The following items can currently be accessed:
  • fuel prices
  • Which User is Online
  • Corporation Member
  • Corporation Cache Money
  • Corporation Tank content
  • Corporation Equipment Storage content
  • Corporation Income from contracts
  • Corporation Transfer (on/off) Money/raw materials/Equipment
If you are interested in further data, write to our developer team using the support form and we will decide whether to release the data for you.
To access corporate data you need a developer code, which we will be happy to provide upon request. This means that unauthorized access to internal group data can be prevented.
Abu Dhabi URL: https://s1.oilimperium.de/interface/oi_4players_01.wsdl
Bahrain URL: http://gamesload.oilimperium.de/interface/oi_gamesload_01.wsdl
List of function names including inputs and outputs:
  • getOilPrice - fuel prices
    int or array getOilPrice( int $id )
    @param int 0 - 3  @return int *
    or
    @param int 4  @return array (0 => crude oil, 1 => Kerosin, 2 => Diesel, 3 => Benzin)
    * 0 = crude oil
    * 1 = Kerosin
    * 2 = Diesel
    * 3 = Benzin
  • getUserOnline - Which user is Online
    array getUserOnline()
    @return array (0 => Anzahl, 1 => array(0 => Name 1, 1 => Name 2) )
  • getCorporateGroupBalance - corperate cache money
    int getCorporateGroupBalance( int $kid, string $code )
    @param int (Corperate ID)
    @param string (Password)
    @return int
  • getCorporateGroupLevel - Konzern tank content
    array getCorporateGroupLevel( int $kid, string $code, int $typ )
    @param int (KoCorperatenzern ID)
    @param string (Password)
    @param int 0 - 3   @return int *
    or
    @param int 4  @return array (0 => crude oil, 1 => Kerosin, 2 => Diesel, 3 => Benzin)
    * 0 = crude oil
    * 1 = Kerosin
    * 2 = Diesel
    * 3 = Benzin
  • getCorporateGroupStock - Corperate Equipment Storage content
    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 = Derrick A
    * 1 = Tank A
    * 2 = Pipeline A
    * 3 = Derrick B
    * 4 = Tank B
    * 5 = Pipeline B
    * 6 = Derrick C
    * 7 = Tank C
    * 8 = Pipeline C
  • getCorporateGroupContractsIn - Corperate income through contracts
    array getCorporateGroupContractsIn( int $kid, string $code, int $time )
    @param int (Corperate ID)
    @param string (Password)
    @param int (TIMESTAMP)
    @return array (array( 0 => VertragsId, 1 => "Umsatz"),
                    array(0 => VertragsId, 1 => "Umsatz"), usw.)
  • getCorporateGroupMember - Corperate members as names or as numbers
    array getCorporateGroupMember( int $kid, string $code, bool $typ )
    @param int (Corperate ID)
    @param string (Password)
    @param bool (false)  @return int
    or
    @param bool (true)  @return array (0 => Name 1, 1 => Name 2)
  • getCorporateGroupTransfer - Corperate Transfer (on/off) money/raw material/Equipment
    array getCorporateGroupTransfer( int $kid, string $code, int $io, int $typ, int $time )
    @param int (Corperate ID)
    @param string (Password)
    @param int (In- Out) *
    @param int (Money/raw materials/Equipment)**
    @param int (TIMESTAMP)
    @return array
    * 1 = Ingoing
    * 2 = Outgoing
    ** 1 = Money
    ** 2 = Equipment
    ** 3 = fuels
There are different ways to process the information. Here is a small example for PHP.
  • Example:

    Start the Soap class from PHP and call a function

    <?php
    # Variablen
    $debug = true; # show debug informationen
    $oi_kid = 0815; # Your corperate ID at Oil Empire
    $oi_code = "foobar"; # Your Developer Code at Oil Empire
    $wsdl_uri = "{var url}/interface/oi_{var game_name}.wsdl";
    path to the Oil Empire WSDL file
    # PHP Errors activate
    if( $debug == true )
    {
    error_reporting(E_ALL);
    ini_set("display_errors","on");
    }
    else
    error_reporting(0);
    # deactivate Soap Cache
    ini_set("soap.wsdl_cache_enabled", 0);
    # connection to the oil empire server
    $soap = new SoapClient($wsdl_uri, array("trace" => 1));
    # show all available functionen
    if( $debug == true )
    {
    $func = $soap->__getFunctions();
    print_r($func);
    }
    # call a Soap function
    $benzin_preis = $soap->getOilPrice(4);
    echo $benzin_preis;
    ?>
    Here you can find a small example code Download.