API Controller Console Manual/en

Aus EUserv Wiki

Wechseln zu: Navigation, Suche

API Controller Console Manual


Inhaltsverzeichnis


Program Preparation


Configuration

In order to use the program you must create a configuration file first, you can us the file “config.ini” in your installation directory. Copy it to a directory you want to use the program from and open the file. Enter the your API user name after “name=”, after “pass=” the password and after “serv=” just enter “Livesystem” or “Sandbox” depending on what you want to use. It is also possible to use any file as configuration, you can read more about this in the section Additional Parameters – config_file.

Test Configuration

Before you enter your data in the configuration file you can test it using the following command. Open your console and switch to the directory which contains the “apicmd.exe”. Next enter the following line:

apicmd.exe "check_login" "'serv'=>'[Sandbox or Livesystem]'; 'name'=>'[the user name]'; 'pass'=>'[the password]';"


Command Syntax


API Commands

A list of all API command can be found in the documentation.

To execute an API command enter it in the following form and replace the brackets with your commands specific data.

apicmd.exe "[API command name]" "'[parameter name]'=>'[parameter value]'; '[additional parameter]'=>'[additional value]';"

Please mind the small ' before, after every parameter and value.

Addition Parameters

The parameters listed here are used by the API Controller only and are not mentioned in the API documentation. They offer additional possibilities to control the API commands. To use these parameters enter them in a second block of parameters after the first, enclosed by “ ” and also use the same form as for the first.

config_file

This parameter can be used with any API command. A path to an alternative configuration file is expected as value. Although this file must contain the same lines as the file “config.ini” in your installation directory.

output_file

This parameter can be used for the command “server.get_traffic_graph”. A path to an output file for the graph image is expected as value. Unlike as described in the documentation this command returns an already decoded PNG file which can be viewed.