Aus EUserv Wiki

(Unterschied zwischen Versionen)

Wechseln zu: Navigation, Suche

Aktuelle Version vom 09:08, 11. Sep. 2019

Languages:

Deutsch • English

Inhaltsverzeichnis

1 EUserv Reseller API
- 1.1 Introduction
- 1.2 History of Changes
2 Method Specifications
3 XML Fault-Codes (Error Messages)

EUserv Reseller API

Introduction

Technology

Our API is based on the XML-RPC protocol, which is a Remote Procedure Calling protocol that works via Internet.

XML-RPC messages are HTTP-POST requests in XML (Extensible Markup Language).

A “method call” will be executed on the server and will produce a response, which is also formatted in XML and which can be decoded into several variables.
Method call parameters and returned variables can be strings, integers (numbers) and also complex types like arrays and hashes. Required parameters and return values are method-specific. Some parameters or return values are marked as “optional”; all other values/parameters are required.

API Servers

Please note that both servers currently use self-signed SSL certificates! It is possible, that you have to disable “peer verifying” to connect!

The live environment is available via HTTPS (HTTP via SSL, Port 443) at:
– https://api.euserv.net:443
For developing/testing purposes, please use the sandbox environment, which is also available via HTTPS(Port 443) at:
– https://api.test.euserv.net:443

The sandbox environment is a virtual environment for testing and developing. All data/values/servers/orders will be copied into the sandbox environment every night, excepting the API user accounts. That means you have to create separate API user accounts within the sandbox environment. Assigned tasks, e.g. server resets or reinstallations, will automatically marked as done every 5 minutes.

PHP Examples

We have added PHP examples to show you, how you can use our API with PHP. In our examples, we use 'XML-RPC for PHP' as the core libary. You can find this libary here:
http://phpxmlrpc.sourceforge.net/.

History of Changes
Version	Changes
0.5.1	- Add method 'server.ipaddr_get_reverse' - Add method 'server.get_possible_server_items' - Add method 'server.order_server'
0.5.2	- Update method 'server.get_possible_server_items' - Update method 'server.order_server'
0.5.3	- Add method 'domain.get_domain_orders' - Add method'domain.get_domain_order_details' - Add method 'domain.dns_create_record' - Add method 'domain.dns_delete_record' - Add method 'domain.dns_update_record' - Add method 'domain.dns_get_active_records' - Add method 'domain.redirect_create_record' - Add method 'domain.redirect_delete_record' - Add method 'domain.redirect_update_record' - Add method 'domain.redirect_get_active_records' - Add internal methods
0.5.4	- Add method 'server.get_traffic_graph' - Update internal methods
0.5.5	- Add/Update internal methods
0.5.6	- Add method 'domain.check' - Add method 'order_external.get_possible_items' - Add method 'order_external.create_order
0.6.9	- Add method 'vserver.list_vservers' - Add method 'vserver.get_details' - Add method 'vserver.reset' - Add method 'server.get_possible_failover_servers' - Add method 'server.get_ipaddr_inetnum_list' - Add method 'server.get_ipaddr_list' - Add method 'server.ipaddr_assign' - Add method 'server.ipaddr_release' - Add method 'server.ipaddr_assign_failover' - Add method 'server.ipaddr_release_failover' - Update method 'server.get_details' - Add/Update internal methods

Method Specifications

Introduction

The following part contains information about method calls, method parameters and method return values.
Generally, if a method call was completed successfully, the return message will include the following status code:

Field	Type	Value
status	int	100

If a method call was failed, a XML-Fault message with “Fault-Code” and “Fault-String” will be returned.(See also chapter “XML Fault-Codes”)

API Debug/Testing Methods

debug.get_api_version

PURPOSE

This Method returns the current API version.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
api_version	string	Current API version

PHP EXAMPLE

API Documentation RunningExamples debug.get_api_version PHP

debug.pingpong

PURPOSE

This Method returns all the parameters, it was called with. You can use it to check the format of your call parameters. Notice that only supported parameter keys with correctly formatted values will be accepted!

CALL PARAMETERS

Every supported parameter key; see parameters of other methods.

RETURNS

Every committed parameter with its committed value.

PHP EXAMPLE

API Documentation RunningExamples debug.pingpong PHP

API User-Management Methods

usermngt.create_acc

PURPOSE

This Method is used to create new API user accounts

CALL PARAMETERS

Field / Key Name	Type	Description
acc_sub_id	string	Name of the new account; will be attached to management account's name separated by a point. (e.g. 'subacc' will become api123.subacc) Required are 3-8 chars [a-z] or [0-9]
acc_passwd_base64	string base64	Password for the new account (has to be base64-encoded) acc_ipv4_bindings string At least one allowed IPv4 address for using the new account. You can specify multiple values; each separated by a semicolon. Network-addresses and IPranges will not work.
acc_allowed_groups (optional)	string	Method group memberships for this account. Management account needs permissions for every mentioned group. You can specify multiple

RETURNS

Field / Key Name	Type	Description
acc_name	string	The complete name of the new account (e.g. 'api1234.subacc')
acc_added_ip_bindings	int	Number (amount) of added IP bindings
acc_added_groups	int	Number (amount) of added group memberships

usermngt.modify_acc

PURPOSE

This Method is used to modify settings and/or permissions of API user accounts.

CALL PARAMETERS

Field / Key Name	Type	Description
acc_id	string	Complete name of the account which will be modified (e.g. 'acc_id' => 'api1234.subacc')
acc_passwd_base64 (optional)	string base64	New account password in base64-encoded format. Using this parameter will overwrite the old password.
acc_ipv4_bindings (optional)	string	At least one allowed IPv4 address for using the new account. You can specify multiple values; each separated by a semicolon. Networkaddresses and IP-ranges will not work. You can specify multiple values, each separated by a semicolon. Using this parameter will overwrite old bindings.
acc_allowed_groups (optional)	string	This parameter will set method group memberships for the account and overwrite existing ones. Management account needs permissions for every mentioned group. You can specify multiple values, each separated by a semicolon. (e.g. 'acc_allowed_groups' => 'domain;server;vserver')
acc_status (optional)	string enum	Parameter to deactivate or to (re-)activate theParameter to deactivate or to (re-)activate the account Value must be “active” or “inactive”

RETURNS

Field / Key Name	Type	Description
acc_password_changed	bool	Shows if password has changed or not
acc_ip_bindings_changed	bool	Shows if IP bindings have changed or not
acc_groups_changed	bool	Shows if group memberships have changed or not
acc_status_changed	bool	Shows if account's status has changed or not (has set active or inactive)

usermngt.list_acc

PURPOSE

This Method is used to get all API user accounts and their settings/details

CALL PARAMETERS

N/A

RETURNS

Field / Key Name

Type

Description

acc_list_count

int

Number (amount) of available API user accounts

acc_list_data

array asoc

Contains all the account data in a multidimensional, associative array.

Array’s keys equals API user’s login names, e.g. $array ['api1234.subacc']

Values are contained in the second dimension, e.g. $array ['api1234.subacc'] ['status']

acc_list_data – Keys of second dimension

Field / Key Name	Type	Description
status	string	Account’s status, can be “active” or “inactive”
created	string	“Datetime” of account creation
lastchange	string	“Datetime” of account’s last change groups array Contains all active method group names (e.g. 0 => “server”, 1 => “vserver”)
ip_bindings	array	Contains all active IP bindings (IP restrictions)

Server-related Methods

server.list_servers

PURPOSE

This Method is used to get all manageable servers and basic details for further method calls. Only these servers which are manageable by the used API user will be returned.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
server_list_count	int	Number (amount) of available servers
server_list_data	array asoc	Contains basic server details in a multidimensional, associative array. Keys of the first dimension equals the server order numbers: e.g. $array ['123456'] Values are contained in the second dimension: e.g. $array ['12345'] ['srv_main_ip'] returns the main

server_list_data – Keys of second dimension

Field / Key Name	Type	Description
order_desc	string	Description/Product name
srv_id	int	Server’s unique ID (required for further method calls)
srv_main_ip	string	Primary IP address
srv_name	string	Server name (for network settings)
status	string enum	Server or order status: - “ready” means server can be used - “in_rescue” means server can be used but it’s currently in rescue mode - “in_process” means server is not available at present - “locked” means server/order is locked by the provider

PHP EXAMPLE

API Documentation RunningExamples server.list_servers PHP

server.get_details

PURPOSE

This Method is used to get all details of a manageable server. Only these servers are available, which are manageable by the used API.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server's unique ID

RETURNS

Field / Key Name	Type	Description
server_details	array (asoc)	Contains all server details in an associative array

server_details – Keys of second dimension

Key Name	Type	Description
order_no	int	Server contract’s order number
order_desc	string	Description/Product name
srv_id	int	Server’s unique ID (required for further method calls)
srv_main_ip	string	Primary IP address
srv_name	string	Server name (for network settings)
srv_netmask	string	Netmask for network / IP address setup
srv_broadcast	string	Broadcast address for network / IP address setup
srv_gateway	string	Gateway address for network / IP address setup
srv_status	string enum	Server or order status: - “ready” means server can be used - “in_rescue” means server is currently in rescue mode - “in_process” means server is not available at present - “locked” means server/order is locked by the provider
srv_default_pw	string	Default password for initial login or rescue usage
srv_mac	string	MAC-Address of server’s first network device
srv_mac2 (optional)	string	MAC-Address of server’s optional second network device
srv_cpu	string	Processor (Product) name / Description
srv_cpu_cores	int	Number of (available) CPU cores
srv_cpu_mhz	int	CPU clock rate in MHz srv_64bit_support bool CPU support for 64bit (true or false)
srv_ram_type	string	Type of used memory (e.g. DDR2-RAM)
srv_ram_size	int	Size of memory in MB
srv_hdd_type	string	Harddisk bus type (e.g. SATA)
srv_hdd_size	int	Size of each hdd (e.g. 250)
srv_hdd_count	int	Number of installed harddisks
srv_has_hwraid	bool	Hardware-RAID support (true or false)
srv_hwraid_level	string	Used Hardware-RAID level (“none” or level, e.g. “1”)
srv_os_id	int	ID of currently used OS image (for reinstall)
srv_os_name	string	Name/description of currently used OS image
srv_os_is_64bit	bool	OS image 64bit support (true or false)
srv_pro_option	int	Server Pro-Option on/off (1/0)
srv_features_prooption_possible	int	Support for Pro-Option (1/0)
srv_features_failover_ip	int	Failover ip feature support (1/0)
srv_features_create_compatible_mac	int	Support for vmware compatible mac addresses (1/0)
srv_ipaddresses_max_without_cost	int	Maximum number of ip addresses without cost
srv_ipaddresses_max_with_cost	int	Maximum number of ip addresses with cost
srv_ipaddresses_max_with	int	Maximum number of ip addresses (without cost + with cost)
srv_ipaddresses_used_without_cost	int	Used number of ip addresses without cost
srv_ipaddresses_used_with_cost	int	Used number of ip addresses with cost
srv_ipaddresses_used_with	int	Used number of ip addresses (without cost + with cost)
srv_ipaddresses_possible_without_cost	int	Assignable number of ip addresses without cost
srv_ipaddresses_possible_with_cost	int	Assignable number of ip addresses with cost
srv_ipaddresses_possible_with	int	Assignable number of ip addresses (without cost + with cost)

PHP EXAMPLE

API Documentation RunningExamples server.get_details PHP

server.get_possible_failover_servers

PURPOSE

This method is used to get all possible servers, which are applicable for failover ip assignments, i.e. which have the failover ip feature enabled. Only servers which are manageable by the used API user will be returned.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
failover_server_list_count	int	Number (amount) of available servers, which are applicable for failover ip assignments
failover_server_list	array asoc	Contains basic server details in a multidimensional, associative array.

failover_server_list – Keys of second dimension

Key Name	Type	Description
ord_id	int	ID of the server order
item_description	string	Description/Product name

METHOD ERRORS

Code	Short Message	Description
1001	nothing found	No possible failover servers found.

PHP EXAMPLE

API Documentation RunningExamples server.get_possible_failover_servers PHP

server.get_possible_os_images

PURPOSE

This Method is used to get all possible OS images for a specific server ID. Only compatible and usable OS images will be returned here.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server's unique ID

RETURNS

Field / Key Name	Type	Description
os_images_asoc_array	array asoc	Contains details of every possible/available OS image in a multidimensional, associative array. Keys of the first dimension equals the OS image number, called “os_id”: e.g. $array ['240'] Values are contained in the second dimension: e.g. $array ['240'] ['os_name'] returns the name/description of OS image with ID 240.

os_images_asoc_array – Keys of second dimension

Key Name	Type	Description
os_id	int	ID of OS image (for reinstall)
os-status	string enum	stable \| unstable \| testing
os_name	string	Name/description of OS image
os_is_64bit	bool	OS image 64bit support (true or false)
os_raidlevel	int	Provided software RAID level or “-1” if none

PHP EXAMPLE

API Documentation RunningExamples server.get_possible_os_images PHP

server.reset

PURPOSE

This Method is used to perform a hard server reset.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server’s unique ID

RETURNS

Only “status” = “100” if request was accepted

PHP EXAMPLE

API Documentation RunningExamples server.reset PHP

server.autoreinstall

PURPOSE

This Method is used to perform an automatic server reinstall with a specified OS image ID. Only compatible images will be accepted – you can obtain a list of all compatible OS images by using the “server.get_possible_os_images” API method.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server’s unique ID
srv_os_id	int	ID of target OS image
srv_perform_reset	bool	Perform automatic server reset, to start installation? (“true” or “false”) If you choose “false” here, you have to perform

RETURNS

Only “status” = “100” if request was accepted

PHP EXAMPLE

API Documentation RunningExamples server.autoreinstall PHP

server.rescue_activate

PURPOSE

This Method is used to activate a rescue system for a specified server, which will be started during next boot.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server's unique ID
srv_perform_reset	bool	Perform automatic server reset, to start rescue system? (“true” or “false”) If you choose “false” here, you have to perform a manual reboot via SSH to start the rescue system.
rescue_mode	int	{optional} the desired rescue mode (1 = enable default rescue, 2 = enable vKVM, 3 = enable Linux rescue 64 bit, 4 = enable rescue 32 bit (only old systems), 5 = enable FreeBSD rescue 64 bit, 6 = enable FreeBSD rescue 32 bit (only old systems), 7 = enable Windows rescue)

RETURNS

Only “status” = “100” if request was accepted

PHP EXAMPLE

API Documentation RunningExamples server.rescue_activate PHP

server.get_ipaddr_inetnum_list

PURPOSE

This method is used to get a list of available ip nets (inetnums). The returned data can be used to assign an ip from a specific range to a server.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
inetnum_list_count	int	Number (amount) of found inetnums
inetnum_list	array asoc	Contains details of available ip nets (inetnums) in a multidimensional, associative array.

inetnum_list – Keys of second dimension

Key Name	Type	Description
ipinet_id	int	ID of the inetnum
ipinet_netip	string	The net ip (e.g. 81.7.17.0)
ipinet_broadcast	string	The broadcast address (e.g. 81.7.17.255)

METHOD ERRORS

Code	Short Message	Description
1001	c_id invalid	Given customer ID is invalid.
1002	internal error	Internal error, please contact the support!
1003	inetnum error	Could not get inetnum list.
1004	ip data error	Could not get ip data.

PHP EXAMPLE

API Documentation RunningExamples server.get_ipaddr_inetnum_list PHP

server.get_ipaddr_list

PURPOSE

This method is used to get a list of ip addresses, which are assigned to the given server order.

CALL PARAMETERS

Field / Key Name	Type	Description
srvord_id	int	Server orders's unique ID

RETURNS

Field / Key Name	Type	Description
ipadd_list_count	int	Number (amount) of found ip addresses.
ipadd_list	array asoc	Contains ip data in a multidimensional, associative array.

ipadd_list – Keys of second dimension

Key Name	Type	Description
ipadd_id	int	ID of the ip address
ipadd_address	string	The ip address
ipinet_broadcast	string	The broadcast address
ipinet_netmask	string	The netmask
ipinet_gateway	string	The gateway address
mac_address	string	The mac address (if assigned)
failover_assigned_from_order	int	If this field is set, the ip is a failover ip, which was assigned from another server order.
failover_assigned_to_order_list	array asoc	This field contains a list of server contracts in a multidimensional, associative array. It is only set, if this ip was assigned as a failover ip to at least one other server order.

failover_assigned_to_order_list – Keys of third dimension

Key Name	Type	Description
ord_id	int	This field contains the unique order id of the server order, where this ip has been assigned as a failover ip

METHOD ERRORS

Code	Short Message	Description
1001	srvord_id not given	The server order id was not given.
1002	no permission	No permission for given server order.
1003	internal error	Internal error, please contact the support!
1004	srvord_id invalid	The given server order id is invalid
1005	internal error	Internal error, please contact the support!
1006	internal error	Internal error, please contact the support!
1007	internal error	Internal error, please contact the support!
1008	server not ready	The order of the given server is not ready.
1009	internal error	Internal error, please contact the support!
1010	internal error	Internal error, please contact the support!
1011	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.get_ipaddr_list PHP

server.ipaddr_get_reverse

PURPOSE

This Method is used to get the current reverse DNS entry (PTR record) for a specified server IP address.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server's unique ID
ip_address	string	IP address to get reverse entry for

RETURNS

Field / Key Name	Type	Description
ip_address	string	IP address for delivered record
ptr_reverse_record	string	Reverse entry (PTR record)

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_get_reverse PHP

server.ipaddr_set_reverse

PURPOSE

This Method is used to set a reverse DNS entry for a specified server IP address.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	Server's unique ID
ip_address	string	IP address to modify reverse entry
reverse_entry	string	Reverse entry for specified IP as hostname/

RETURNS

Only “status” = “100” if request was accepted

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_set_reverse PHP

server.ipaddr_assign

PURPOSE

This method is used to assign a coip to the given server.

CALL PARAMETERS

Field / Key Name	Type	Description
srvord_id	int	Server order's unique ID, where the ip address is assigned
ipinet_id(optional)	int	ID of the ip range (inetnum), from where the ip is assigned
mac_vmware_compatible(optional)	string	Use vmware compatible mac address off/on (0/1)

RETURNS

Field / Key Name	Type	Description
ipadd_id	int	Unique ID of the assigned ip address

METHOD ERRORS

Code	Short Message	Description
1001	srvord_id not given	The server order id was not given.
1002	no permission	No permission for given server order.
1003	internal error	Internal error, please contact the support!
1004	srvord_id invalid	The given server order id is invalid
1005	internal error	Internal error, please contact the support!
1006	server not ready	The order of the given server is not ready.
1007	internal error	Internal error, please contact the support!
1008	c_id invalid	Customer id is invalid.
1009	internal error	Internal error, please contact the support!
1010	internal error	Internal error, please contact the support!
1011	ipinet_id invalid	The given ipinet_id is invalid.
1012	internal error	Internal error, please contact the support!
1013	ip max reached	The maximum number of ip addresses for the given server order is reached.
1014	internal error	Internal error, please contact the support!
1015	internal error	Internal error, please contact the support!
1016	internal error	Internal error, please contact the support!
1017	internal error	Internal error, please contact the support!
1018	internal error	Internal error, please contact the support!
1019	internal error	Internal error, please contact the support!
1020	internal error	Internal error, please contact the support!
1021	internal error	Internal error, please contact the support!
1022	internal error	Internal error, please contact the support!
1023	internal error	Internal error, please contact the support!
1024	internal error	Internal error, please contact the support!
1025	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_assign PHP

server.ipaddr_release

PURPOSE

This method is used to release a coip from a server.

CALL PARAMETERS

Field / Key Name	Type	Description
ipadd_id	int	Unique ID of the ip address to release

RETURNS

Only “status” = “100” if request was accepted

METHOD ERRORS

Code	Short Message	Description
1001	ipadd_id not given	The ipadd_id was not given.
1002	ipadd_id invalid	The given ipadd_id is invalid.
1003	ipadd_id invalid	The given ipadd_id is invalid.
1004	ipadd_id invalid	The given ipadd_id is invalid.
1005	already released	The given ip is already released.
1006	internal error	Internal error, please contact the support!
1007	server not ready	The order of the given server is not ready.
1008	no permission	No permission for server order.
1009	internal error	Internal error, please contact the support!
1010	internal error	Internal error, please contact the support!
1011	not releasable	The given ip is not releasable.
1012	internal error	Internal error, please contact the support!
1013	internal error	Internal error, please contact the support!
1014	internal error	Internal error, please contact the support!
1015	internal error	Internal error, please contact the support!
1016	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_release PHP

server.ipaddr_assign_failover

PURPOSE

This method is used to assign a coip to the given server as a failover ip.

CALL PARAMETERS

Field / Key Name	Type	Description
ipadd_id	int	Unique ID of the ip address, used as a failover ip
srvord_id	int	Server order's unique ID, where the ip address is assigned

RETURNS

Only “status” = “100” if request was accepted

METHOD ERRORS

Code	Short Message	Description
1001	ipadd_id not given	The ipadd_id was not given.
1002	ipadd_id invalid	The given ipadd_id is invalid.
1003	srvord_id not given	The server order id for the failover server was not given.
1004	no permission	No permission for the given failover server.
1005	internal error	Internal error, please contact the support!
1006	server not ready	The order of the given failover server is not ready.
1007	internal error	Internal error, please contact the support!
1008	server not ready	The given failover server is not ready.
1009	ipadd_id invalid	The given ipadd_id is invalid.
1010	ipadd_id invalid	The given ipadd_id is invalid.
1011	ipadd_id invalid	The given ipadd_id is invalid.
1012	internal error	Internal error, please contact the support!
1013	internal error	Internal error, please contact the support!
1014	no permission	No permission for the given server.
1015	internal error	Internal error, please contact the support!
1016	server not ready	The order of the given server is not ready.
1017	server order error	The given server order and the server order of the given ipadd_id cannot be the same.
1018	internal error	Internal error, please contact the support!
1019	internal error	Internal error, please contact the support!
1020	feature unavailable	On of the servers does not support the failover ip feature.
1021	already assigned	The given ip is already assigned to the given failover server.
1022	already assigned	The given ip cannot be assigned more than once without Pro-Option.
1023	internal error	Internal error, please contact the support!
1024	internal error	Internal error, please contact the support!
1025	internal error	Internal error, please contact the support!
1026	internal error	Internal error, please contact the support!
1027	internal error	Internal error, please contact the support!
1028	internal error	Internal error, please contact the support!
1029	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_assign_failover PHP

server.ipaddr_release_failover

PURPOSE

This method is used to release a failover coip from a server.

CALL PARAMETERS

Field / Key Name	Type	Description
ipadd_id	int	Unique ID of the failover ip address to release
srvord_id	int	Server order's unique ID, where the given ip address is assigned as a failover ip

RETURNS

Only “status” = “100” if request was accepted

METHOD ERRORS

Code	Short Message	Description
1001	ipadd_id not given	The ipadd_id was not given.
1002	ipadd_id invalid	The given ipadd_id is invalid.
1003	srvord_id not given	The server order id for the failover server was not given.
1004	internal error	Internal error, please contact the support!
1005	internal error	Internal error, please contact the support!
1006	internal error	Internal error, please contact the support!
1007	internal error	Internal error, please contact the support!
1008	ipadd_id invalid	The given ipadd_id is invalid.
1009	ipadd_id invalid	The given ipadd_id is invalid.
1010	internal error	Internal error, please contact the support!
1011	server not ready	The given server is not ready.
1012	no permission	No permission for the given server.
1013	internal error	Internal error, please contact the support!
1014	internal error	Internal error, please contact the support!
1015	not assigned	The given ip is not assigned to the given server.
1016	internal error	Internal error, please contact the support!
1017	internal error	Internal error, please contact the support!
1018	internal error	Internal error, please contact the support!
1019	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.ipaddr_release_failover PHP

server.ipv6addr_set_main

PURPOSE - (server.ipv6addr_set_main)

Creates a IPv6 address for the server.

CALL PARAMETERS - (server.ipv6addr_set_main)

Field / Key Name	Type	Description
srv_id	int	Server's unique ID/

RETURNS - (server.ipv6addr_set_main)

Field / Key Name	Type	Description
srv_main_ipv6	string	New IPv6 address

METHOD ERRORS - (server.ipv6addr_set_main)

Code	Short Message	Description
1001	ipv6 address already exist	The main IPv6 address is already set.
1002	can not find ipv6prefix	The IPv6 prefix can not be found.
1003	can not find ipv4 adress	The server is not ready yet.
1004	can not generade ipv6 address	Internal error. Please contact the support!

PHP EXAMPLE - (server.ipv6addr_set_main)

API Documentation RunningExamples server.ipv6addr_set_main PHP

server.ipv6addr_get_reverse

PURPOSE - (server.ipv6addr_get_reverse)

This Method is used to get the current reverse DNS entry (PTR record) for a specified server IPv6 address.

CALL PARAMETERS - (server.ipv6addr_get_reverse)

Field / Key Name	Type	Description
srv_id	int	Server's unique ID
ipv6_address	string	IPv6 address to get reverse entry for

RETURNS - (server.ipv6addr_get_reverse)

Field / Key Name	Type	Description
ipv6_address	string	IPv6 address for delivered record
reverse_entry	string	Reverse entry (PTR record)

METHOD ERRORS - (server.ipv6addr_get_reverse)

Code	Short Message	Description
1001	ipv6address not linked to srv_id	The given IPv6 address is not linked to the Server.
1002	no reverse-entry linked	There is no reverse_entry linked to the IPv6 address.

PHP EXAMPLE - (server.ipv6addr_get_reverse)

API Documentation RunningExamples server.ipv6addr_get_reverse PHP

server.ipv6addr_set_reverse

PURPOSE - (server.ipv6addr_set_reverse)

This Method is used to set a reverse DNS entry for a specified server IPv6 address.

CALL PARAMETERS - (server.ipv6addr_set_reverse)

Field / Key Name	Type	Description
srv_id	int	Server's unique ID
ipv6_address	string	IPv6 address to modify reverse entry
reverse_entry	string	Reverse entry for specified IP as hostname/

RETURNS - (server.ipv6addr_set_reverse)

Field / Key Name	Type	Description
ipv6_address	string	IPv6 address for delivered record
reverse_entry	string	Reverse entry (PTR record)

METHOD ERRORS - (server.ipv6addr_set_reverse)

Code	Short Message	Description
1001	ipv6address not linked to srv_id	The given IPv6 address is not linked to the Server.
1002	internal error	Internal error. Please contact the support!
1003	internal error	Internal error. Please contact the support!
1004	internal error	Internal error. Please contact the support!
1005	no reverse_entry linked	There is no reverse_entry linked to ipv6 address function.

PHP EXAMPLE - (server.ipv6addr_set_reverse)

API Documentation RunningExamples server.ipv6addr_set_reverse PHP

server.get_possible_server_items

PURPOSE

This Method is used to display all possible server-items you can order. Please note that this function only available for Reseller.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
possible_server_items	array (asoc)	Contains all possible serveritems in a associative array

possible_server_items - Keys of second dimension

Key Name	Type	Description
item_id	int	Server-item unique ID
item_name	string	The name of the server-item
item_net_amount	string	The net amount of the serveritem (per billing period)
item_gross_amount	string	The gross amount of the serveritem (per billing period)
item_net_setup_fee	string	The net setup fee (unique) of the server-item
item_gross_setup_fee	string	The gross setup fee (unique) of the server-item
item_billing_period	int	The period you have to pay for your server (in months)
item_contract_running_time	int	The running time of the contract

METHOD ERRORS

Code	Short Message	Description
1001	can not load customer_id	Error while loading the customer_id from api-user. Please contact the support!
1002	can not load as_id	Error while loading the as_id from api-user. Please contact the support!
1003	internal error	Internal error. Please contact the support!
1004	no possible items found	There are no possible serveritems you can order.
1005	this function is only available for reseller	You are not a reseller, you can not use this function.

PHP EXAMPLE

API Documentation RunningExamples server.get_possible_server_items PHP

server.order_server

PURPOSE

This method is used to order some server. Please note that this function only available for Reseller.

CALL PARAMETERS

Field / Key Name	Type	Description
<item_id>	int	Use the item_id of the serveritem you want to order as a key and the quantity of the server as the value eg. '11716' => '1' (order one server with the item_id '11716')
accept_terms_and_conditions	bool	Set this flag to accept the terms and conditions(0 = NO, 1= YES). If you don't accept the terms and conditions, you can't order server. The terms and conditions can be found here: http://euserv.de/unternehmen/agb.php
accept_special_terms_and_conditions_rootserver	bool	Set this flag to accept the spezial terms and conditions rootserver(0 = NO, 1= YES). If you don't accept the spezial terms and conditions rootserver, you can't order server. The spezial terms and conditions rootserver can be found here: http://euserv.de/produkte/server/tosfdrs.php

RETURNS

Field / Key Name	Type	Description
total_amount	string	The total amount for the server you have ordered

METHOD ERRORS

Code	Short Message	Description
1001	can not load customer_id	Error while loading the customer_id from api-user. Please contact the support!
1002	can not load a_id	Error while laoding the as_id from api-user. Please contact the support!
1003	terms and conditions must be accepted	To order server you must accept the terms and conditions.
1004	special terms and conditions rootserver must be accepted	To order server you must accept the spezial terms and conditions rootserver.
1005	internal error	Internal error. Please contact the support!
1006	no items found	No items found. Please check your request.
1007	internal error	Internal error. Please contact the support!
1008	invalid item_id found	One of your item-ids is invalid. Please check your request.
1009	internal error	Internal error. Please contact the support!
1010	this function is only available for reseller	You are not a reseller, you can not use this function.

PHP EXAMPLE

API Documentation RunningExamples server.order_server PHP

server.get_traffic_graph

PURPOSE

This method is used to get a traffic-graph for your server.

CALL PARAMETERS

Field / Key Name	Type	Description
srv_id	int	The id of the server for which you want to get a traffic-graph.
graph_mode(optional)	int	The mode of the graph you want to get (0 = LAST DAY, 1 = LAST WEEK,2 = LAST MONTH,3 = LAST YEAR).
graph_language(optional)	string	The language of the graph you want to get (ISO Country Code, lower case). Possible types are 'en', 'de'. Default is 'en'.

RETURNS

Field / Key Name	Type	Description
traffic_graph	string	The base64 encoded data of the graph you want to get.

METHOD ERRORS

Code	Short Message	Description
1001	srv_id not given	The srv_id was not given.
1002	srv_graph_mode not valid	The given srv_graph_mode is not valid.
1003	can not load portdata	Cannot load portdata, please contact the support!
1004	can not load portdata	Cannot load portdata, please contact the support!
1005	can not load portdata	Cannot load portdata, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples server.get_traffic_graph PHP

server.get_traffic

PURPOSE

This method reads the traffic of the submitted srvord_id and returns this.

CALL PARAMETERS

Field / Key Name	Type	Description
srvord_id	int	The srvord_id od the desired server.
startdate(optional)	string	The startdate, format YYYY-mm-dd, if start date and end date are not specified the actual month is shown.
enddate(optional)	string	The end date, format YYYY-mm-dd, if start date and end date are not specified the actual month is shown.
date_format(optional)	string	The format in which the date should be issued, DEFAULT YYYY-mm-dd, details: HERE
unit_type(optional)	int	The desired unit in which all be returned, possible values 1 = Kilobyte, 2 = Megabyte, 3 = Gigabyte, DEFAULT byte

RETURNS

Field / Key Name	Type	Description
status	int	100 (everything ok - traffic has been read)
traffic_data	array_asoc	A href of traffic data in which element ID is a sequential number (start = 0, end = traffic_data_count - 1)
traffic_data_count	int	The number of elements in traffic_data
traffic_sum	float	The number of the traffic over the desired period of time

traffic_data – Keys of second dimension

Key Name	Type	Description
Element ID	array_asoc	the id of the element in the array

traffic_data – Keys of third dimension

Key Name	Type	Description
date	string	The date of the entry in the desired format
in	float	the incoming traffic in the desired format
out	float	the outgoing traffic in the desired format
sum	float	the entire traffic in the desired format

Domain-related Methods

domain.get_domain_orders

PURPOSE

This method is used to give you an overview of your domain orders an their features.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
domain_orders	array asoc	Contains domain order data

Keys of the second dimension

Field / Key Name	Type	Description
<order_id>	array asoc	Contains domain order data

Key of the third dimension

Field / Key Name	Type	Description
domain_id	int	The id of the current domain.
domain_name	string	The name of the current domain.
domain_name_idn	string	The name idn of the current domain.
feature_redirect	int	Tells you, if the redirect feature is disabled or enabled(0/1).
feature_dns	int	Tells you, if the redirect feature is disabled or enabled(0/1).

METHOD ERRORS

Code	Short Message	Description
1001	can not load customer data	Error while loading the customer data. Please contact the support!
1002	no domain orders found	No domain orders can be found.

PHP EXAMPLE

API Documentation RunningExamples domain.get_domain_orders PHP

domain.get_domain_order_details

PURPOSE

This method is used to get the details of the domain order.

CALL PARAMETERS

Field / Key Name	Type	Description
order_id	int	The order id of that order you want to see the details.

RETURNS

Field / Key Name	Type	Description
domain_order_details	array asoc	Contains domain order details.

domain_order_details - Keys of the second dimension

Field / Key Name	Type	Description
order_id	array asoc	Contains domain order details.

<order_id> - Keys of the third dimension

Field / Key Name	Type	Description
order_status	int	The current order status(1 = ready, 3 = in process, 11 = transfer in process, 12 = waiting)
domain_id	int	The domain id of the current domain.
domain_name	string	The domain name of the current domain.
domain_name_idn	string	The domain name of the current domain.
dns_record_type	array asoc	An array asoc of available dns record types and there data .(A, AAAA, MX, AFSDB, CERT, CNAME, DNSKEY, DS, HINFO, KEY, LOC, NAPTR, NSEC, RP, RRSIG, SPF, SSHFP, SRV, TXT)
redirect_record_type	array asoc	An array asoc of available redirect record types(frameredirect, headerredirect)
redirect_record_max	int	The maximum of redirect records you can create.
redirect_record_used	int	The count of used redirect records.
redirect_record_free	int	The count of free redirect records.

dns_record_type - Keys of the fourth dimension

Field / Key Name	Type	Description
<dns_record_type>	array asoc	An array asoc of the current dns record type data.

<dns_record_type> - Keys of the fifth dimension

Field / Key Name	Type	Description
dns_record_max	int	The maximum of dns records you can create.
dns_record_used	int	The count of dns records you have already used.
dns_record_free	int	The count of free dns records.

redirect_record_type – Keys of the fourth dimension

Field / Key Name	Type	Description
<redirect_record_type>	int	A flag that tells you if the redirect_record_type is available.

METHOD ERRORS

Code	Short Message	Description
1001	order_id is invalid	The given order id is invalid
1002	order_id is not managed by api user	The given order id is not managed by you
1003	domain order not found	The given domain order was not found.
1004	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExample domain.get_domain_order_details PHP

domain.dns_create_record

PURPOSE

This method is used to create an dns record for your domain.

CALL PARAMETERS

Field / Key Name	Type	Description
domain_id	int	The domain id of the domain you want to create a dns record.
dns_record_subdomain (optional)	string	The subdomain of the dns record you want to create.
dns_record_type	string	The type of the dns record you want to create. Possible Types are A, AAAA, MX, AFSDB, CERT, CNAME, DNSKEY, DS, HINFO, KEY, LOC, NAPTR, NSEC, RP, RRSIG, SPF, SSHFP, SRV, TXT
dns_record_value	string	The value of the dns record you want to create ( e.g euserv.de).
dns_record_prio (optional)	int	The record prio of the dns record you want to create(only essential for mx records).
dns_record_ttl	int	The ttl of the dns record you want to create. At least 43200.

RETURNS

Field / Key Name	Type	Description
dns_record_id	int	The id of the dns record you have created.

METHOD ERRORS

Code	Short Message	Description
1001	domain_id not given	The domain_id was not given.
1002	dns_record_subdomain invalid	The given dns_record_subdomain is invalid.
1003	dns_record_type not given	The dns_record_type was not given.
1004	dns_record_type not valid	The given dns_record_type is not valid.
1005	dns_record_value not given	The dns_record_value was not given.
1006	dns_record_value not valid	The given dns_record_value is not valid.
1007	dns_record_prio not given	You want to create an mx record and no dns_record_prio was given.
1008	dns_record_ttl not given or to low	The dns_record_ttl was not given or lower then 43200.
1009	domain not found	There are no domain found for domain_id.
1010	order not ready	The domain order is not ready so you can't create dns records.
1011	domain not managed by customer	The domain of the given domain_id was not managed by you.
1012	internal error	Internal error, please contact the support!
1013	can not load domain data	Cannot load domain data, please contact the support!
1014	internal error	Cannot load domain data, please contact the support!
1015	dns_record_type not possible in this order	The given dns_record_type is not available in your domain order.
1016	dns_record limit reached	The dns record limit has been reached.
1017	internal error	Internal error, please contact the support!
1018	dns_record already exits	The dns record you want to create already exits.
1019	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples domain.dns_create_record PHP

domain.dns_delete_record

PURPOSE

This method is used create a dns record of your domain.

CALL PARAMETERS

Field / Key Name	Type	Description
dns_record_id	int	The id of the dns record you want to delete.

RETURNS

Only 'status' = '100' if request was accepted.

METHOD ERRORS

Code	Short Message	Description
1001	customer_id not given	Internal error, please contact the support!
1002	dns_record_id not given	There are no dns_record_id given.
1003	dns_record not found	No dns record found for dns_record_id.
1004	order not ready	The order of the dns_record_id is not ready.
1005	dns_record not managed by customer	The dns record is not managed by you.

PHP EXAMPLE

API Documentation RunningExamples domain.dns_delete_record PHP

domain.dns_update_record

PURPOSE

This method is used to update a dns record for your domain.

CALL PARAMETERS

Field / Key Name	Type	Description
dns_record_id	int	The id of the dns record you want to update.
dns_record_value(optional)	string	The new dns record value of the dns record you want to update
dns_record_prio(optional)	int	The new prio of the dns_record you want to update (only essential for mx records).
dns_record_ttl(optional)	int	The new ttl of the dns record you want to update. At least 43200.

RETURNS

Only 'status' = '100' if request was accepted.

METHOD ERRORS

Code	Short Message	Description
1001	nothing to do	There is nothing to do! You send an empty request.
1002	dns_record_id not given	The dns_record_id was not given.
1003	dns_record_id not valid	The given dns_record_id is not valid.
1004	internal error	Internal error, please contact the support!
1005	dns_record_type not valid	Internal error, please contact the support!
1006	dns_record_value not valid	The given dns_record_value is not valid.
1007	dns_record_type not accept dns_record_prio	You send dns_record_prio but the current dns_record_type does not accept dns_record_prio.
1008	dns_record_ttl to low	The given dns_record_ttl is lower 43200.
1009	dns_record not found	No dns record found for dns_record_id.
1010	order not ready	The Domainorder is not in the status 'ready'.
1011	dns_record not managed by customer	The dns_record of the given dns_record_id is not managed by you.
1012	internal error	Internal error, please contact the support!
1013	internal error	Internal error, please contact the support!
1014	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples domain.dns_update_record PHP

domain.dns_get_active_records

PURPOSE

This method is used to show all activ dns records.

CALL PARAMETERS

Field / Key Name	Type	Description
domain_id	int	The domain_id of the domain for which you want to see all the dns records.

RETURNS

Field / Key Name	Type	Description
dns_records	array asoc	An array asoc of all activ dns records for your domain.

dns_records - Keys of the second dimension.

Field / Key Name	Type	Description
<dns_record_id>	array asoc	An array asoc with all data of the dns record.

<dns_record_id> - Keys of the third dimension

Field / Key Name	Type	Description
dns_record_name	string	The full name of the current dns record.
dns_record_type	string	The type of the current dns record.
dns_record_content	string	The content of the current dns record.
dns_record_ttl	int	The ttl of the current dns record.
dns_record_prio	int	The prio of the current dns record(only on mx records).

METHOD ERRORS

Code	Short Message	Description
1001	customer_id not given	Internal error, please contact the support!
1002	domain_id not given	There is no domain_id given.
1003	domain not found	No domain found for domain_id.
1004	order not ready	The order of the domain_id is not ready.
1005	domain not managed by customer	domain not managed by customer
1006	no dns_record found	No dns records found for domain.

PHP EXAMPLE

API Documentation RunningExamples domain.dns_get_active_records PHP

domain.redirect_create_record

PURPOSE

This method is used to create a redirect record.

CALL PARAMETERS

Field / Key Name	Type	Description
domain_id	int	The domain_id of the domain you want to create a redirect record for.
redirect_record_type	string	The type of redirect record you want to create. Possible types are frameredirect or headerredirect
redirect_record_subdomain (optional)	string	The subdomain of the redirect record you want to create.
redirect_record_location	string	The location of the redirect_record. Only URL start with http:// OR https://).
redirect_record_status_code (optional)	int	An webserver status code that describes the type of redirection(Only for redirect_record_type headerredirect). Available codes are 301, 302 and 307.
redirect_record_title (optional)	string	The title of your redirect record (Only for frameredirect).
redirect_record_description (optional)	string	The description of you redirect record (Only for frameredirect).
redirect_record_author (optional)	string	The description of you redirect record (Only for frameredirect).
redirect_record_keywords (optional)	string	The keywords of your redirect record (Only for frameredirect).
redirect_record_robots (optional)	string	The robot description of your redirect_record (Only for frameredirect).
redirect_record_favicon (optional)	string	The favicon url of your redirect_record (Only for frameredirect).

RETURNS

Field / Key Name	Type	Description
redirect_record_id	int	The id of the redirect record you have created.

METHOD ERRORS

Code	Short Message	Description
1001	domain_id not given	The domain_id was not given.
1002	redirect_record_type not given	The redirect_record_type was not given
1003	parameter redirect_record_title, redirect_record_description, redirect_record_author, redirect_record_keywords, redirect_record_robots, redirect_record_favicon not available for redirect_record_type	You send invalid parameter for headerredirect.
1004	redirect_record_location not given	The redirect_record_location was not given.
1005	redirect_record_status_code not given	The redirect_record_status_code was not given.
1006	parameter redirect_record_status_code not available for redirect_record_type	You send invalid parameter for frameredirect.
1007	redirect_record_location not valid	The given redirect_record_location is not valid.
1008	domain not found	No domain found for domain_id.
1009	order not ready	The domain order is not ready so you cannot create redirect records.
1010	domain not managed by customer	The domain of the given domain_id was not managed by you.
1011	internal error	Internal error, please contact the support!
1012	internal error	Internal error, please contact the support!
1013	internal error	Internal error, please contact the support!
1014	redirect is not available	The redirect feature is not available for this domain.
1015	<redirect_record_type> is not available	<redirect_record_type> is not available in this order.
1016	redirect limit reached	The redirect limit has reached.
1017	redirect_record_wildcard is not available	You want to set an wildcard and wildcard is not available for your order.
1018	internal error	Internal error, please contact the support!
1019	redirect_record already exits	The redirect record you want to create already exits.

PHP EXAMPLE

API Documentation RunningExamples domain.redirect_create_record PHP

domain.redirect_delete_record

PURPOSE

This method is used to delete a redirect record.

CALL PARAMETERS

Field / Key Name	Type	Description
redirect_record_id	int	The id of the redirect record you want to delete.

RETURNS

Only 'status' = '100' if request was accepted.

METHOD ERRORS

Code	Short Message	Description
1001	customer_id not given	Internal error, please contact the support!
1002	redirect_record_id not given	Internal error, please contact the support!
1003	redirect_record not found	No redirect record found for redirect_record id.
1004	order not ready	The order of the redirect record id is not ready.
1005	redirect_record not managed by customer	The redirect record is not managed by you.

PHP EXAMPLE

API Documentation RunningExamples domain.redirect_delete_record PHP

domain.redirect_update_record

PURPOSE

This method is used to update a redirect record.

CALL PARAMETERS

Field / Key Name	Type	Description
redirect_record_id	int	The id of the redirect record you want to update.
redirect_record_location (optional)	string	The location of the redirect record you want to update. Only URL start with http:// OR https://).
redirect_record_status_code (optional)	int	An webserver status code that describes the type of redirection (Only for redirect_record_type headerredirect). Available codes are 301, 302 and 307.
redirect_record_title (optional)	string	The title of your redirect record (Only for frameredirect).
redirect_record_description (optional)	string	The description of you redirect record (Only for frameredirect).
redirect_record_author (optional)	string	The description of you redirect record (Only for frameredirect).
redirect_record_keywords (optional)	string	The robots description of your redirect_record (Only for frameredirect).
redirect_record_favicon (optional)	string	The favicon url of your redirect_record (Only for frameredirect).

RETURNS

Only 'status' = '100' if request was accepted.

METHOD ERRORS

Code	Short Message	Description
1001	redirect_record_id not given	The redirect_record_id was not given.
1002	redirect_record not found	No redirect record found for redirect_record id.
1003	order not ready	The order of the redirect record id is not ready.
1004	redirect_record not managed by customer	The redirect record is not managed by you.
1005	internal error	Internal error, please contact the support!
1006	internal error	Internal error, please contact the support!
1007	redirect_record_type not valid	Internal error, please contact the support!
1008	parameter redirect_record_title, redirect_record_description, redirect_record_author, redirect_record_keywords, redirect_record_robots, redirect_record_favicon not available for redirect_record_type	The current redirect record is a headerredirect and you send invalid parameter.
1009	nothing to do	There is nothing to do.
1010	parameter redirect_record_status_code not available for redirect_record_type	The current redirect record is a frameredirect and you send invalid parameter.
1011	nothing to do	There is nothing to do.
1012	internal error	Internal error, please contact the support!
1013	internal error	Internal error,please contact the support!

PHP EXAMPLE

API Documentation RunningExamples domain.redirect_update_record PHP

domain.redirect_get_active_records

PURPOSE

This method is used to show all activ redirect records.

CALL PARAMETERS

Field / Key Name	Type	Description
domain_id	int	The domain_id of the domain for which you want to see all the redirect records.

RETURNS

Field / Key Name	Type	Description
redirect_records	array asoc	An array asoc of all activ redirect records for your domain.

redirect_records - Keys of the second dimension

Field / Key Name	Type	Description
<redirect_record_id>	array asoc	An array asoc with all data of the redirect record.

<redirect_record_id> - Keys of the third dimension

Field / Key Name	Type	Description
redirect_record_type	string	The type of the current redirect record.
redirect_record_status_code	int	The Webserver status code of the current redirect record. (only on headerredirect records)
redirect_record_name	string	The name of the current redirect record.
redirect_record_location	string	The location of the current redirect record.
redirect_record_title	string	The title of the current redirect record (only on frameredirect records).
redirect_record_description	string	The description of the current redirect record (only on frameredirect records).
redirect_record_author	string	The author of the current redirect record (only on frameredirect records).
redirect_record_keywords	string	The keywords of the current redirect record (only on frameredirect records).
redirect_record_robots	string	The robots description of the current redirect record (only on frameredirect records).
redirect_record_favicon	string	The favicon url of the current redirect record (only on frameredirect records).

METHOD ERRORS

Code	Short Message	Description
1001	customer_id not given	Internal error, please contact the support!
1002	domain_id not given	There is no domain_id given.
1003	domain not found	No domain found for domain id.
1004	order not ready	The order of the domain id is not ready.
1005	domain not managed by customer	The domain is not managed by you.
1006	no redirect records found	No redirect records found for domain.

PHP EXAMPLE

API Documentation RunningExamples domain.redirect_get_active_records PHP

domain.check

PURPOSE

This method is used for a short check if the domain is available.

CALL PARAMETERS

Field / Key Name	Type	Description
domain_name	string	The name of the domain you want to check.

RETURNS

Field / Key Name	Type	Description
is_available	int	0(domain is not available) or 1 (domain is available)

PHP EXAMPLE

API Documentation RunningExamples domain.check PHP

Order-related Methods

order_external.get_possible_items

PURPOSE

This method is used to get a list of items that can be ordered.

CALL PARAMETERS

Field / Key Name	Type	Description
item_group	string	The item group you want to show. Possible item groups are server, vserver, cloud, hosting, mail or domain.
item_name_regexp (optional)	string	A regex to limit the result by item_name

RETURNS

Field / Key Name	Type	Description
item_list	array asoc	A list of all possible items.
item_list_count	int	The count of the itemlist .

item_list - Keys of the second dimension

Field / Key Name	Type	Description
<item_list_id>	array asoc	An array asoc with all data of the item.

<item_list_id> - Keys of the third dimension

Field / Key Name	Type	Description
item_id	int	The id of the item.
item_name	string	The name of the item.
item_billing_period	int	The billing period of the item.
item_contract_period	int	The contract period of the item.
item_mrc	string	Monthly recurring costs of the item.
item_nrc	string	Non recurring costs of the item.
item_nrc_sale	string	Non recurring costs of the item if sale is active(only present if sale is active for this item).

METHOD ERRORS

Code	Short Message	Description
1001	internal error	Internal error, please contact the support!
1002	item_group not given	There is no item group given.
1003	item_group invalid	The item group is not valid.
101004	pg_id invalid	Internal error, please contact the support!
101005	can not load data	Item data can not be load.

PHP EXAMPLE

API Documentation RunningExamples order_external.get_possible_items PHP

order_external.create_order

PURPOSE

This method is used for to create orders.

CALL PARAMETERS

Field / Key Name	Type	Description
item_id	int	The item id of your destination item.
domain_name (optional)	string	The domain name for your order need for item group domain, hosting and mail.
domain_authcode (optional)	string	The authcode for your domain if your domain is not free.

RETURNS

Field / Key Name	Type	Description
total_amount_formatted	string	The amount of your order in format '0,00'.
total_amount	float	The amount of your order in float format ('0.00').

METHOD ERRORS

Code	Short Message	Description
1001	internal error	Internal error, please contact the support!
1002	tac not accepted	Tac not accepted, please accept tac!
1003	item_id not given	The item id has not been given!
1004	item_id invalid	The item id is invalid.
1005	item_id invalid	The item id is invalid.
1006	item_id invalid	The item id is invalid.
1007	item_id invalid	The item id is invalid.
1008	item_id invalid	The item id is invalid.
1009	internal error	Internal error, please contact the support!
1010	domain_name not given	Domain name needed but not given.
1011	domain_name invalid	Domain name is not valid.
1012	domain_name not possible for item_id	Domain name is not valid for this item id.
1013	domain_name invalid	Domain name is not valid.
1014	internal error	Internal error, please contact the support!
1015	internal error	Internal error, please contact the support!
1016	domain_authcode not given	Domain authcode needed but not given.
1017	internal error	Internal error, please contact the support!
1018	internal error	Internal error, please contact the support!
1019	internal error	Internal error, please contact the support!

PHP EXAMPLE

API Documentation RunningExamples order external.create_order PHP

vServer-related Methods

vserver.list_vservers

PURPOSE

This Method is used to get all manageable vServers and basic details for further method calls. Only these vServers which are manageable by the used API user will be returned.

CALL PARAMETERS

N/A

RETURNS

Field / Key Name	Type	Description
vserver_list_count	int	Number (amount) of available vservers
vserver_list_data	array asoc	Contains basic vserver details in a multidimensional, associative array. Keys of the first dimension equals the vserver order numbers: e.g. $array ['123456'] Values are contained in the second dimension: e.g. $array ['12345'] ['vsrv_main_ip'] returns the main

vserver_list_data – Keys of second dimension

Field / Key Name	Type	Description
order_desc	string	Description/Product name
vsrvord_id	int	vServer’s unique ID (required for further method calls)
vsrv_main_ip	string	Primary IP address
vsrv_name	string	vServer name (for network settings)
status	string enum	vServer or order status: - “ready” means vserver can be used - “in_rescue” means vserver can be used but it’s currently in rescue mode - “in_process” means vserver is not available at present - “locked” means vserver/order is locked by the provider

PHP EXAMPLE

API_Documentation_RunningExamples_vserver.list_vservers_PHP

vserver.get_details

PURPOSE

This Method is used to get all details of a manageable vserver. Only these vservers are available, which are manageable by the used API.

CALL PARAMETERS

Field / Key Name	Type	Description
vsrvord_id	int	vServer's unique ID

RETURNS

Field / Key Name	Type	Description
vserver_details	array (asoc)	Contains all vserver details in an associative array

vserver_details – Keys of second dimension

Key Name	Type	Description
order_no	int	vServer contract’s order number
order_desc	string	Description/Product name
vsrvord_id	int	vServer’s unique ID (required for further method calls)
vsrv_main_ip	string	Primary IP address
vsrv_name	string	vServer name (for network settings)
vsrv_name_reverse	string	vServer reversename (for network settings)
vsrv_netmask	string	Netmask for network / IP address setup
vsrv_broadcast	string	Broadcast address for network / IP address setup
vsrv_gateway	string	Gateway address for network / IP address setup
vsrv_status	string enum	vServer or order status: - “ready” means vserver can be used - “in_rescue” means vserver is currently in rescue mode - “in_process” means vserver is not available at present - “locked” means vserver/order is locked by the provider
vsrv_default_pw	string	Default password for initial login or rescue usage
vsrv_os_id	int	ID of currently used OS image (for reinstall)
vsrv_os_name	string	Name/description of currently used OS image
vsrv_os_is_64bit	bool	OS image 64bit support (true or false)

METHOD ERRORS

Code	Short Message	Description
1001	vsrvord_id not valid	The vsrvord_id is not valid.
1002	vsrvord_id not valid	The vsrvord_id is not valid.
1003	vsrvord_id not valid	The vsrvord_id is not valid.
1004	vsrvord_id not assigned to customer	The vsrvord_id is not assigned to your customer account.
1005	internal error	Internal error, please contact the support!
1006	internal error	Internal error, please contact the support!
1007	internal error	Internal error, please contact the support!
1008	internal error	Internal error, please contact the support!
1009	internal error	Internal error, please contact the support!
1010	internal error	Internal error, please contact the support!
1011	internal error	Internal error, please contact the support!

PHP EXAMPLE

API_Documentation_RunningExamples_vserver.get_details_PHP

vserver.reset

PURPOSE

This Method is used to perform a vserver reset.

CALL PARAMETERS

Field / Key Name	Type	Description
vsrvord_id	int	vServer’s unique ID

RETURNS

Only “status” = “100” if request was accepted

METHOD ERRORS

Code	Short Message	Description
1001	vsrvord_id not valid	The vsrvord_id is not valid.
1002	vsrvord_id not valid	The vsrvord_id is not valid.
1003	vsrvord_id not valid	The vsrvord_id is not valid.
1004	vsrvord_id not assigned to customer	The vsrvord_id is not valid.
1005	internal error	Internal error, please contact the support!
1006	internal error	Internal error, please contact the support!
1007	internal error	Internal error, please contact the support!
1008	internal error	Internal error, please contact the support!
1009	internal error	Internal error, please contact the support!
1010	internal error	Internal error, please contact the support!
1011	internal error	Internal error, please contact the support!

PHP EXAMPLE

API_Documentation_RunningExamples_vserver.reset_PHP

XML Fault-Codes (Error Messages)

Internal Errors
Code	Short Message	Description
10001	Service temporary not available	Service temporary not available. Try again later.
10021	Internal database error	Error while connecting to internal database. Please contact the support!
10022	Internal database error	Error while execute SQL-Query. Please contact the support!
10041	No such method: <method name>	The requested method does not exist.
10042	Method temporary locked: <method name>	The requested method is locked at present. Try again later.
10043	Internal error in method: <method name>	No return from called method. Please contact the support!
10044	Internal error in method: <method name>	<Method returned an (internal) error.

Request Errors / Sanity Check Errors
Code	Short Message	Description
10002	Wrong HTTP-Header	HTTP-Header error: No 'method' declared
10003	Wrong HTTP-Header	HTTP-Header error: 'method' must be 'POST'
10004	Wrong HTTP-Header	HTTP-Header error: No 'contenttype' declared
10005	Wrong HTTP-Header	HTTP-Header error: 'contenttype' must be 'text/xml'
10006	Wrong HTTP-Header	HTTP-Header error: 'contentlength' required
10007	Wrong HTTP-Header	HTTP-Header error: 'contentlength' cannot be zero
10008	Request error: length mismatch	Length of request does not match with notation in header. See 'content-length' in header.
10009	Request is too large	Exceeding of maximum request length
10010	Missing required parameter: <parameter>	Given parameter is required by called method but it is missing.
10011	Wrong parameter format: <parameter>	Given parameter is in a wrong format. Please check api documentation.
10012	Unknown value for parameter <param> : <value>	Given value for mentioned key is unknown or incorrect. Maybe a typo?
10013	Unknown parameter: <parameter>	Given parameter is unknown. Maybe a typo?

Authentication Errors
Code	Short Message	Description
10031	Authentication failed	Authentication failed: empty username
10032	Authentication failed	Authentication failed: empty passphrase
10033	Authentication failed	Authentication failed: no such user / wrong password / account locked / no permission
10034	Authentication failed	IP address restriction: remote address does not match.
10035	Authentication failed	Error in user accounting settings, no main account specified. Please contact support.
10036	Authentication failed	Responsible management account is locked.
10039	Permission denied.	User has no permission for called method.

API User-Management Errors
Code	Short Message	Description
11001	Name/ID not available	Provided acc_sub_id is not available for creation or already exists.
11002	Internal error while creating subaccount.	Internal error, please contact support.
11003	No permission for group <group>	Main account has no permission for mentioned group.
11006	Max. user accounts reached	Unable to create a new user account due max. user account restriction. Please contact support for further capability!
11010	Unable to modify account: <acc_id>	Provided acc_sub_id does not exist or permission was denied.

@@ Zeile 1: / Zeile 1: @@
-{{Languages|EUserv Reseller API Developer Guide and Reference}}
+{{Languages|API Documentation}}
+[[Kategorie:Server]]
 [[Kategorie:Servers]]
+[[Kategorie:Domain]]
 [[Kategorie:Domain/en]]
 __TOC__
@@ Zeile 10: / Zeile 13: @@
 === Technology ===
-Our API is based on the XML-RPC protocol, which is a Remote Procedure Calling protocol that works over the Internet.
+Our API is based on the XML-RPC protocol, which is a Remote Procedure Calling protocol that works via Internet.
 XML-RPC messages are HTTP-POST requests in XML (Extensible Markup Language).
@@ Zeile 22: / Zeile 25: @@
 </div>
-The live environment is available over HTTPS (HTTP over SSL, Port 443) at: <br>
+The live environment is available via HTTPS (HTTP via SSL, Port 443) at: <br>
 '''– https://api.euserv.net:443''' <br>
-For developing/testing purposes, please use the sandbox environment, which is also available over HTTPS(Port 443) at: <br>
+For developing/testing purposes, please use the sandbox environment, which is also available via HTTPS(Port 443) at: <br>
 '''– https://api.test.euserv.net:443'''
@@ Zeile 33: / Zeile 36: @@
 http://phpxmlrpc.sourceforge.net/.
-'''History of Changes'''
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|colspan="2" style="background-color:rgb(230,230,230)"|
-{|width="100%" cellspacing="0" border="2px solid"
+== History of Changes ==
 |-
-|'''Version'''                     ||'''Changes'''
+|width="50%" background-color="rgb(230,230,230)"|'''Version'''                     ||width=50%;|'''Changes'''
 |-
 |0.5.1                             ||- Add method 'server.ipaddr_get_reverse'<br> - Add method 'server.get_possible_server_items'<br> - Add method 'server.order_server'
@@ Zeile 43: / Zeile 47: @@
 |0.5.2                             || - Update method 'server.get_possible_server_items'<br> - Update method 'server.order_server'
 |-
-|0.5.3                             || - Add method 'domain.get_domain_orders'<br>- Add method'domain.get_domain_order_details'<br> - Add method 'domain.dns_create_record'<br>
+|0.5.3                             || - Add method 'domain.get_domain_orders'<br>- Add method'domain.get_domain_order_details'<br> - Add method 'domain.dns_create_record'<br> - Add method 'domain.dns_delete_record'<br>- Add method 'domain.dns_update_record'<br>- Add method 'domain.dns_get_active_records'<br>- Add method 'domain.redirect_create_record'<br>- Add method 'domain.redirect_delete_record'<br>- Add method 'domain.redirect_update_record'<br>- Add method 'domain.redirect_get_active_records'<br>- Add internal methods<br>
-- Add method 'domain.dns_delete_record'<br>
-- Add method 'domain.dns_update_record'<br>
-- Add method 'domain.dns_get_active_records'<br>
-- Add method 'domain.redirect_create_record'<br>
-- Add method 'domain.redirect_delete_record'<br>
-- Add method 'domain.redirect_update_record'<br>
-- Add method 'domain.redirect_get_active_records'<br>
-- Add internal methods<br>
 |-
 |0.5.4                              ||- Add method 'server.get_traffic_graph'<br> - Update internal methods
+|-
+|0.5.5                              ||- Add/Update internal methods
+|-
+|0.5.6                              ||- Add method 'domain.check'<br> - Add method 'order_external.get_possible_items'  <br> - Add method 'order_external.create_order
+|-
+|0.6.9                              ||- Add method 'vserver.list_vservers'<br>- Add method 'vserver.get_details'<br>- Add method 'vserver.reset'<br>- Add method 'server.get_possible_failover_servers'<br>- Add method 'server.get_ipaddr_inetnum_list'<br>- Add method 'server.get_ipaddr_list'<br>- Add method 'server.ipaddr_assign'<br>- Add method 'server.ipaddr_release'<br>- Add method 'server.ipaddr_assign_failover'<br>- Add method 'server.ipaddr_release_failover'<br>- Update method 'server.get_details'<br>- Add/Update internal methods<br>
 |}
 <br>
 = Method Specifications =
 ----
@@ Zeile 61: / Zeile 68: @@
 The following part contains information about method calls, method parameters and method return values.<br>
 Generally, if a method call was completed successfully, the return message will include the following status code:<br>
-{|width="100%" cellspacing="0" border="2px solid"
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
 |-
-|'''Field''' ||'''Type''' || '''Value'''
+|style="background-color:rgb(230,230,230)"|'''Field''' ||style="background-color:rgb(230,230,230)"|'''Type''' ||style="background-color:rgb(230,230,230)"| '''Value'''
 |-
 |status      ||int        ||100
@@ Zeile 72: / Zeile 79: @@
 == API Debug/Testing Methods ==
 === debug.get_api_version ===
+----
 ==== PURPOSE ====
 This Method returns the current API version.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|api_version      ||string        ||Current API version
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples debug.get_api_version PHP]]
+=== debug.pingpong ===
+----
+==== PURPOSE ====
+This Method returns all the parameters, it was called with. You can use it to check the format of your call parameters. Notice that only supported parameter keys with correctly formatted values will be accepted!
+==== CALL PARAMETERS ====
+Every supported parameter key; see parameters of other methods.
+==== RETURNS ====
+Every committed parameter with its committed value.
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples debug.pingpong PHP]]
+== API User-Management Methods ==
+=== usermngt.create_acc ===
+----
+==== PURPOSE ====
+This Method is used to create new API user accounts
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|acc_sub_id      ||string        ||Name of the new account; will be attached to management account's name separated by a point. (e.g. 'subacc' will become api123.subacc) Required are 3-8 chars [a-z] or [0-9]
+|-
+|acc_passwd_base64 ||string base64 ||Password for the new account (has to be base64-encoded) acc_ipv4_bindings string At least one allowed IPv4 address for using the new account. You can specify multiple values; each separated by a semicolon. Network-addresses and IPranges will not work.
+|-
+|acc_allowed_groups (optional)||string||Method group memberships for this account. Management account needs permissions for every mentioned group. You can specify multiple
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|acc_name || string || The complete name of the new account (e.g. 'api1234.subacc')
+|-
+|acc_added_ip_bindings || int || Number (amount) of added IP bindings
+|-
+|acc_added_groups ||int || Number (amount) of added group memberships
+|}
+=== usermngt.modify_acc ===
+----
+==== PURPOSE ====
+This Method is used to modify settings and/or permissions of API user accounts.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|acc_id || string || Complete name of the account which will be modified (e.g. 'acc_id' => 'api1234.subacc')
+|-
+|acc_passwd_base64 (optional)||string base64||New account password in base64-encoded format. Using this parameter will overwrite the old password.
+|-
+|acc_ipv4_bindings (optional)|| string || At least one allowed IPv4 address for using the new account. You can specify multiple values; each separated by a semicolon. Networkaddresses and IP-ranges will not work. You can specify multiple values, each separated by a semicolon. Using this parameter will overwrite old bindings.
+|-
+|acc_allowed_groups (optional)||string||This parameter will set method group memberships for the account and overwrite existing ones. Management account needs permissions for every mentioned group. You can specify multiple values, each separated by a semicolon. (e.g. 'acc_allowed_groups' => 'domain;server;vserver')
+|-
+|acc_status (optional)||string enum||Parameter to deactivate or to (re-)activate theParameter to deactivate or to (re-)activate the account Value must be “active” or “inactive”
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|acc_password_changed||bool||Shows if password has changed or not
+|-
+|acc_ip_bindings_changed||bool||Shows if IP bindings have changed or not
+|-
+|acc_groups_changed||bool||Shows if group memberships have changed or not
+|-
+|acc_status_changed||bool||Shows if account's status has changed or not (has set active or inactive)
+|}
+=== usermngt.list_acc ===
+----
+==== PURPOSE ====
+This Method is used to get all API user accounts and their settings/details
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|acc_list_count||int||Number (amount) of available API user accounts
+|-
+|acc_list_data||array asoc || Contains all the account data in a multidimensional, associative array. <br>
+Array’s keys equals API user’s login names, e.g. $array ['api1234.subacc'] <br>
+Values are contained in the second dimension, e.g. $array ['api1234.subacc'] ['status']
+|}
+==== acc_list_data – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|status||string||Account’s status, can be “active” or “inactive”
+|-
+|created||string||“Datetime” of account creation
+|-
+|lastchange||string||“Datetime” of account’s last change groups array Contains all active method group names (e.g. 0 => “server”, 1 => “vserver”)
+|-
+|ip_bindings||array||Contains all active IP bindings (IP restrictions)
+|}
+== Server-related Methods ==
+=== server.list_servers ===
+----
+==== PURPOSE ====
+This Method is used to get all manageable servers and basic details for further method calls. Only these servers which are manageable by the used API user will be returned.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|server_list_count||int||Number (amount) of available servers
+|-
+|server_list_data||array asoc||Contains basic server details in a multidimensional, associative array. Keys of the first dimension equals the server order numbers: e.g. $array ['123456'] Values are contained in the second dimension: e.g. $array ['12345'] ['srv_main_ip'] returns the main
+|}
+==== server_list_data – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_desc||string||Description/Product name
+|-
+|srv_id||int||Server’s unique ID (required for further method calls)
+|-
+|srv_main_ip||string||Primary IP address
+|-
+|srv_name||string||Server name (for network settings)
+|-
+|status||string enum||Server or order status:<br> - “ready” means server can be used<br> - “in_rescue” means server can be used but it’s currently in rescue mode<br> - “in_process” means server is not available at present<br> - “locked” means server/order is locked by the provider
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.list_servers PHP]]
+=== server.get_details ===
+----
+==== PURPOSE ====
+This Method is used to get all details of a manageable server. Only these servers are available, which are manageable by the used API.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|}
+====RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|server_details||array (asoc)||Contains all server details in an associative array
+|}
+==== server_details – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_no||int||Server contract’s order number
+|-
+|order_desc||string||Description/Product name
+|-
+|srv_id||int||Server’s unique ID (required for further method calls)
+|-
+|srv_main_ip||string||Primary IP address
+|-
+|srv_name||string||Server name (for network settings)
+|-
+|srv_netmask||string||Netmask for network / IP address setup
+|-
+|srv_broadcast||string||Broadcast address for network / IP address setup
+|-
+|srv_gateway||string||Gateway address for network / IP address setup
+|-
+|srv_status||string enum || Server or order status:<br>- “ready” means server can be used <br> - “in_rescue” means server is currently in rescue mode<br> - “in_process” means server is not available at present<br>- “locked” means server/order is locked by the provider
+|-
+|srv_default_pw||string||Default password for initial login or rescue usage
+|-
+|srv_mac||string||MAC-Address of server’s first network device
+|-
+|srv_mac2 (optional)||string||MAC-Address of server’s optional second network device
+|-
+|srv_cpu||string||Processor (Product) name / Description
+|-
+|srv_cpu_cores||int||Number of (available) CPU cores
+|-
+|srv_cpu_mhz||int||CPU clock rate in MHz srv_64bit_support bool CPU support for 64bit (true or false)
+|-
+|srv_ram_type||string||Type of used memory (e.g. DDR2-RAM)
+|-
+|srv_ram_size||int||Size of memory in MB
+|-
+|srv_hdd_type||string||Harddisk bus type (e.g. SATA)
+|-
+|srv_hdd_size||int||Size of each hdd (e.g. 250)
+|-
+|srv_hdd_count||int||Number of installed harddisks
+|-
+|srv_has_hwraid||bool||Hardware-RAID support (true or false)
+|-
+|srv_hwraid_level||string||Used Hardware-RAID level (“none” or level, e.g. “1”)
+|-
+|srv_os_id||int||ID of currently used OS image (for reinstall)
+|-
+|srv_os_name||string||Name/description of currently used OS image
+|-
+|srv_os_is_64bit||bool||OS image 64bit support (true or false)
+|-
+|srv_pro_option||int||Server Pro-Option on/off (1/0)
+|-
+|srv_features_prooption_possible||int||Support for Pro-Option (1/0)
+|-
+|srv_features_failover_ip||int||Failover ip feature support (1/0)
+|-
+|srv_features_create_compatible_mac||int||Support for vmware compatible mac addresses (1/0)
+|-
+|srv_ipaddresses_max_without_cost||int|| Maximum number of ip addresses without cost
+|-
+|srv_ipaddresses_max_with_cost||int|| Maximum number of ip addresses with cost
+|-
+|srv_ipaddresses_max_with||int|| Maximum number of ip addresses (without cost + with cost)
+|-
+|srv_ipaddresses_used_without_cost||int|| Used number of ip addresses without cost
+|-
+|srv_ipaddresses_used_with_cost||int|| Used number of ip addresses with cost
+|-
+|srv_ipaddresses_used_with||int|| Used number of ip addresses (without cost + with cost)
+|-
+|srv_ipaddresses_possible_without_cost||int|| Assignable number of ip addresses without cost
+|-
+|srv_ipaddresses_possible_with_cost||int|| Assignable number of ip addresses with cost
+|-
+|srv_ipaddresses_possible_with||int|| Assignable number of ip addresses (without cost + with cost)
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.get_details PHP]]
+=== server.get_possible_failover_servers ===
+----
+==== PURPOSE ====
+This method is used to get all possible servers, which are applicable for failover ip assignments, i.e. which have the failover ip feature enabled. Only servers which are manageable by the used API user will be returned.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|failover_server_list_count||int||Number (amount) of available servers, which are applicable for failover ip assignments
+|-
+|failover_server_list||array asoc||Contains basic server details in a multidimensional, associative array.
+|}
+==== failover_server_list – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ord_id||int||ID of the server order
+|-
+|item_description||string||Description/Product name
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||nothing found ||No possible failover servers found.
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.get_possible_failover_servers PHP]]
+=== server.get_possible_os_images ===
+----
+==== PURPOSE ====
+This Method is used to get all possible OS images for a specific server ID. Only compatible and usable OS images will be returned here.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id || int|| Server's unique ID
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|os_images_asoc_array||array asoc||Contains details of every possible/available OS image in a multidimensional, associative array. Keys of the first dimension equals the OS image number, called “os_id”: e.g. $array ['240'] Values are contained in the second dimension: e.g. $array ['240'] ['os_name'] returns the name/description of OS image with ID 240.
+|}
+==== os_images_asoc_array – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|os_id||int||ID of OS image (for reinstall)
+|-
+|os-status||string enum||Development-status of OS image: stable | stable | unstable | testing
+|-
+|os_name||string||Name/description of OS image
+|-
+|os_is_64bit||bool||OS image 64bit support (true or false)
+|-
+|os_raidlevel||int||Provided software RAID level or “-1” if none
+|}
+====PHP EXAMPLE====
+[[API Documentation RunningExamples server.get_possible_os_images PHP]]
+=== server.reset ===
+----
+==== PURPOSE ====
+This Method is used to perform a hard server reset.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server’s unique ID
+|}
+====RETURNS====
+Only “status” = “100” if request was accepted
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.reset PHP]]
+=== server.autoreinstall ===
+----
+==== PURPOSE ====
+This Method is used to perform an automatic server reinstall with a specified OS image ID. Only compatible images will be accepted – you can obtain a list of all compatible OS images by using the “server.get_possible_os_images” API method.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server’s unique ID
+|-
+|srv_os_id||int||ID of target OS image
+|-
+|srv_perform_reset||bool||Perform automatic server reset, to start installation? (“true” or “false”) If you choose “false” here, you have to perform
+|}
+==== RETURNS ====
+Only “status” = “100” if request was accepted
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.autoreinstall PHP]]
+=== server.rescue_activate ===
+----
+==== PURPOSE ====
+This Method is used to activate a rescue system for a specified server, which will be started during next boot.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|-
+|srv_perform_reset||bool||Perform automatic server reset, to start rescue system? (“true” or “false”)<br>If you choose “false” here, you have to perform a manual reboot via SSH to start the rescue system.
+|-
+|rescue_mode||int||{optional} the desired rescue mode (1 = enable default rescue, 2 = enable vKVM, 3 = enable Linux rescue 64 bit, 4 = enable rescue 32 bit (only old systems), 5 = enable FreeBSD rescue 64 bit, 6 = enable FreeBSD rescue 32 bit (only old systems), 7 = enable Windows rescue)
+|}
+====RETURNS====
+Only “status” = “100” if request was accepted
+====PHP EXAMPLE====
+[[API Documentation RunningExamples server.rescue_activate PHP]]
+=== server.get_ipaddr_inetnum_list ===
+----
+==== PURPOSE ====
+This method is used to get a list of available ip nets (inetnums). The returned data can be used to assign an ip from a specific range to a server.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|inetnum_list_count||int||Number (amount) of found inetnums
+|-
+|inetnum_list||array asoc||Contains details of available ip nets (inetnums) in a multidimensional, associative array.
+|}
+==== inetnum_list – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipinet_id||int||ID of the inetnum
+|-
+|ipinet_netip||string||The net ip (e.g. 81.7.17.0)
+|-
+|ipinet_broadcast||string||The broadcast address (e.g. 81.7.17.255)
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||c_id invalid ||Given customer ID is invalid.
+|-
+|1002||internal error ||Internal error, please contact the support!
+|-
+|1003||inetnum error ||Could not get inetnum list.
+|-
+|1004||ip data error ||Could not get ip data.
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.get_ipaddr_inetnum_list PHP]]
+=== server.get_ipaddr_list ===
+----
+==== PURPOSE ====
+This method is used to get a list of ip addresses, which are assigned to the given server order.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srvord_id || int|| Server orders's unique ID
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_list_count||int||Number (amount) of found ip addresses.
+|-
+|ipadd_list||array asoc||Contains ip data in a multidimensional, associative array.
+|}
+==== ipadd_list – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_id||int||ID of the ip address
+|-
+|ipadd_address||string||The ip address
+|-
+|ipinet_broadcast||string||The broadcast address
+|-
+|ipinet_netmask||string||The netmask
+|-
+|ipinet_gateway||string||The gateway address
+|-
+|mac_address||string||The mac address (if assigned)
+|-
+|failover_assigned_from_order||int||If this field is set, the ip is a failover ip, which was assigned from another server order.
+|-
+|failover_assigned_to_order_list||array asoc||This field contains a list of server contracts in a multidimensional, associative array. It is only set, if this ip was assigned as a failover ip to at least one other server order.
+|}
+==== failover_assigned_to_order_list – Keys of third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ord_id||int||This field contains the unique order id of the server order, where this ip has been assigned as a failover ip
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||srvord_id not given ||The server order id was not given.
+|-
+|1002||no permission ||No permission for given server order.
+|-
+|1003||internal error ||Internal error, please contact the support!
+|-
+|1004||srvord_id invalid ||The given server order id is invalid
+|-
+|1005||internal error ||Internal error, please contact the support!
+|-
+|1006||internal error ||Internal error, please contact the support!
+|-
+|1007||internal error ||Internal error, please contact the support!
+|-
+|1008||server not ready ||The order of the given server is not ready.
+|-
+|1009||internal error ||Internal error, please contact the support!
+|-
+|1010||internal error ||Internal error, please contact the support!
+|-
+|1011||internal error ||Internal error, please contact the support!
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.get_ipaddr_list PHP]]
+=== server.ipaddr_get_reverse ===
+----
+==== PURPOSE ====
+This Method is used to get the current reverse DNS entry (PTR record) for a specified server IP address.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|-
+|ip_address||string||IP address to get reverse entry for
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ip_address||string||IP address for delivered record
+|-
+|ptr_reverse_record||string||Reverse entry (PTR record)
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.ipaddr_get_reverse PHP]]
+=== server.ipaddr_set_reverse ===
+----
+==== PURPOSE ====
+This Method is used to set a reverse DNS entry for a specified server IP address.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|-
+|ip_address||string||IP address to modify reverse entry
+|-
+|reverse_entry||string||Reverse entry for specified IP as hostname/
+|}
+==== RETURNS ====
+Only “status” = “100” if request was accepted
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.ipaddr_set_reverse PHP]]
+=== server.ipaddr_assign ===
+----
+==== PURPOSE ====
+This method is used to assign a coip to the given server.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srvord_id||int||Server order's unique ID, where the ip address is assigned
+|-
+|ipinet_id(optional)||int||ID of the ip range (inetnum), from where the ip is assigned
+|-
+|mac_vmware_compatible(optional)||string||Use vmware compatible mac address off/on (0/1)
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_id||int||Unique ID of the assigned ip address
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||srvord_id not given ||The server order id was not given.
+|-
+|1002||no permission ||No permission for given server order.
+|-
+|1003||internal error ||Internal error, please contact the support!
+|-
+|1004||srvord_id invalid ||The given server order id is invalid
+|-
+|1005||internal error ||Internal error, please contact the support!
+|-
+|1006||server not ready ||The order of the given server is not ready.
+|-
+|1007||internal error ||Internal error, please contact the support!
+|-
+|1008||c_id invalid ||Customer id is invalid.
+|-
+|1009||internal error ||Internal error, please contact the support!
+|-
+|1010||internal error ||Internal error, please contact the support!
+|-
+|1011||ipinet_id invalid ||The given ipinet_id is invalid.
+|-
+|1012||internal error ||Internal error, please contact the support!
+|-
+|1013||ip max reached ||The maximum number of ip addresses for the given server order is reached.
+|-
+|1014||internal error ||Internal error, please contact the support!
+|-
+|1015||internal error ||Internal error, please contact the support!
+|-
+|1016||internal error ||Internal error, please contact the support!
+|-
+|1017||internal error ||Internal error, please contact the support!
+|-
+|1018||internal error ||Internal error, please contact the support!
+|-
+|1019||internal error ||Internal error, please contact the support!
+|-
+|1020||internal error ||Internal error, please contact the support!
+|-
+|1021||internal error ||Internal error, please contact the support!
+|-
+|1022||internal error ||Internal error, please contact the support!
+|-
+|1023||internal error ||Internal error, please contact the support!
+|-
+|1024||internal error ||Internal error, please contact the support!
+|-
+|1025||internal error ||Internal error, please contact the support!
+|-
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.ipaddr_assign PHP]]
+=== server.ipaddr_release ===
+----
+==== PURPOSE ====
+This method is used to release a coip from a server.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_id||int||Unique ID of the ip address to release
+|}
+==== RETURNS ====
+Only “status” = “100” if request was accepted
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipadd_id not given ||The ipadd_id was not given.
+|-
+|1002||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1003||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1004||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1005||already released ||The given ip is already released.
+|-
+|1006||internal error ||Internal error, please contact the support!
+|-
+|1007||server not ready ||The order of the given server is not ready.
+|-
+|1008||no permission ||No permission for server order.
+|-
+|1009||internal error ||Internal error, please contact the support!
+|-
+|1010||internal error ||Internal error, please contact the support!
+|-
+|1011||not releasable ||The given ip is not releasable.
+|-
+|1012||internal error ||Internal error, please contact the support!
+|-
+|1013||internal error ||Internal error, please contact the support!
+|-
+|1014||internal error ||Internal error, please contact the support!
+|-
+|1015||internal error ||Internal error, please contact the support!
+|-
+|1016||internal error ||Internal error, please contact the support!
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.ipaddr_release PHP]]
+=== server.ipaddr_assign_failover ===
+----
+==== PURPOSE ====
+This method is used to assign a coip to the given server as a failover ip.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_id||int||Unique ID of the ip address, used as a failover ip
+|-
+|srvord_id||int||Server order's unique ID, where the ip address is assigned
+|}
+==== RETURNS ====
+Only “status” = “100” if request was accepted
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipadd_id not given ||The ipadd_id was not given.
+|-
+|1002||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1003||srvord_id not given ||The server order id for the failover server was not given.
+|-
+|1004||no permission ||No permission for the given failover server.
+|-
+|1005||internal error ||Internal error, please contact the support!
+|-
+|1006||server not ready ||The order of the given failover server is not ready.
+|-
+|1007||internal error ||Internal error, please contact the support!
+|-
+|1008||server not ready ||The given failover server is not ready.
+|-
+|1009||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1010||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1011||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1012||internal error ||Internal error, please contact the support!
+|-
+|1013||internal error ||Internal error, please contact the support!
+|-
+|1014||no permission ||No permission for the given server.
+|-
+|1015||internal error ||Internal error, please contact the support!
+|-
+|1016||server not ready ||The order of the given server is not ready.
+|-
+|1017||server order error ||The given server order and the server order of the given ipadd_id cannot be the same.
+|-
+|1018||internal error ||Internal error, please contact the support!
+|-
+|1019||internal error ||Internal error, please contact the support!
+|-
+|1020||feature unavailable ||On of the servers does not support the failover ip feature.
+|-
+|1021||already assigned ||The given ip is already assigned to the given failover server.
+|-
+|1022||already assigned ||The given ip cannot be assigned more than once without Pro-Option.
+|-
+|1023||internal error ||Internal error, please contact the support!
+|-
+|1024||internal error ||Internal error, please contact the support!
+|-
+|1025||internal error ||Internal error, please contact the support!
+|-
+|1026||internal error ||Internal error, please contact the support!
+|-
+|1027||internal error ||Internal error, please contact the support!
+|-
+|1028||internal error ||Internal error, please contact the support!
+|-
+|1029||internal error ||Internal error, please contact the support!
+|-
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.ipaddr_assign_failover PHP]]
+=== server.ipaddr_release_failover ===
+----
+==== PURPOSE ====
+This method is used to release a failover coip from a server.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipadd_id||int||Unique ID of the failover ip address to release
+|-
+|srvord_id||int||Server order's unique ID, where the given ip address is assigned as a failover ip
+|}
+==== RETURNS ====
+Only “status” = “100” if request was accepted
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipadd_id not given ||The ipadd_id was not given.
+|-
+|1002||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1003||srvord_id not given ||The server order id for the failover server was not given.
+|-
+|1004||internal error ||Internal error, please contact the support!
+|-
+|1005||internal error ||Internal error, please contact the support!
+|-
+|1006||internal error ||Internal error, please contact the support!
+|-
+|1007||internal error ||Internal error, please contact the support!
+|-
+|1008||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1009||ipadd_id invalid ||The given ipadd_id is invalid.
+|-
+|1010||internal error ||Internal error, please contact the support!
+|-
+|1011||server not ready ||The given server is not ready.
+|-
+|1012||no permission ||No permission for the given server.
+|-
+|1013||internal error ||Internal error, please contact the support!
+|-
+|1014||internal error ||Internal error, please contact the support!
+|-
+|1015||not assigned ||The given ip is not assigned to the given server.
+|-
+|1016||internal error ||Internal error, please contact the support!
+|-
+|1017||internal error ||Internal error, please contact the support!
+|-
+|1018||internal error ||Internal error, please contact the support!
+|-
+|1019||internal error ||Internal error, please contact the support!
+|-
+|}
+==== PHP EXAMPLE&nbsp; ====
+[[API Documentation RunningExamples server.ipaddr_release_failover PHP]]
+=== server.ipv6addr_set_main ===
+----
+==== PURPOSE - (server.ipv6addr_set_main) ====
+Creates a IPv6 address for the server.
+==== CALL PARAMETERS - (server.ipv6addr_set_main) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID/
+|}
+==== RETURNS - (server.ipv6addr_set_main) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_main_ipv6||string||New IPv6 address
+|}
+==== METHOD ERRORS - (server.ipv6addr_set_main) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipv6 address already exist ||The main IPv6 address is already set.
+|-
+|1002||can not find ipv6prefix ||The IPv6 prefix can not be found.
+|-
+|1003||can not find ipv4 adress ||The server is not ready yet.
+|-
+|1004||can not generade ipv6 address||Internal error. Please contact the support!
+|}
+==== PHP EXAMPLE - (server.ipv6addr_set_main) ====
+[[API Documentation RunningExamples server.ipv6addr_set_main PHP]]
+=== server.ipv6addr_get_reverse ===
+----
+==== PURPOSE - (server.ipv6addr_get_reverse) ====
+This Method is used to get the current reverse DNS entry (PTR record) for a specified server IPv6 address.
+==== CALL PARAMETERS - (server.ipv6addr_get_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|-
+|ipv6_address||string||IPv6 address to get reverse entry for
+|}
+==== RETURNS - (server.ipv6addr_get_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipv6_address||string||IPv6 address for delivered record
+|-
+|reverse_entry||string||Reverse entry (PTR record)
+|}
+==== METHOD ERRORS - (server.ipv6addr_get_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipv6address not linked to srv_id ||The given IPv6 address is not linked to the Server.
+|-
+|1002||no reverse-entry linked||There is no reverse_entry linked to the IPv6 address.
+|}
+==== PHP EXAMPLE - (server.ipv6addr_get_reverse) ====
+[[API Documentation RunningExamples server.ipv6addr_get_reverse PHP]]
+=== server.ipv6addr_set_reverse ===
+----
+==== PURPOSE - (server.ipv6addr_set_reverse) ====
+This Method is used to set a reverse DNS entry for a specified server IPv6 address.
+==== CALL PARAMETERS - (server.ipv6addr_set_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||Server's unique ID
+|-
+|ipv6_address||string||IPv6 address to modify reverse entry
+|-
+|reverse_entry||string||Reverse entry for specified IP as hostname/
+|}
+==== RETURNS - (server.ipv6addr_set_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|ipv6_address||string||IPv6 address for delivered record
+|-
+|reverse_entry||string||Reverse entry (PTR record)
+|}
+==== METHOD ERRORS - (server.ipv6addr_set_reverse) ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||ipv6address not linked to srv_id ||The given IPv6 address is not linked to the Server.
+|-
+|1002||internal error ||Internal error. Please contact the support!
+|-
+|1003||internal error||Internal error. Please contact the support!
+|-
+|1004||internal error||Internal error. Please contact the support!
+|-
+|1005||no reverse_entry linked||There is no reverse_entry linked to ipv6 address  function.
+|}
+==== PHP EXAMPLE - (server.ipv6addr_set_reverse) ====
+[[API Documentation RunningExamples server.ipv6addr_set_reverse PHP]]
+=== server.get_possible_server_items ===
+----
+==== PURPOSE ====
+This Method is used to display all possible server-items you can order. Please note that this function only available for Reseller.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|possible_server_items||array (asoc)||Contains all possible serveritems in a associative array
+|}
+==== possible_server_items - Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|item_id||int||Server-item unique ID
+|-
+|item_name||string||The name of the server-item
+|-
+|item_net_amount||string||The net amount of the serveritem (per billing period)
+|-
+|item_gross_amount||string||The gross amount of the serveritem (per billing period)
+|-
+|item_net_setup_fee||string||The net setup fee (unique) of the server-item
+|-
+|item_gross_setup_fee||string||The gross setup fee (unique) of the server-item
+|-
+|item_billing_period||int||The period you have to pay for your server (in months)
+|-
+|item_contract_running_time||int||The running time of the contract
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||can not load customer_id||Error while loading the customer_id from api-user. Please contact the support!
+|-
+|1002||can not load as_id||Error while loading the as_id from api-user. Please contact the support!
+|-
+|1003||internal error||Internal error. Please contact the support!
+|-
+|1004||no possible items found||There are no possible serveritems you can order.
+|-
+|1005||this function is only available for reseller||You are not a reseller, you can not use this function.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.get_possible_server_items PHP]]
+=== server.order_server ===
+----
+==== PURPOSE ====
+This method is used to order some server. Please note that this function only available for Reseller.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<item_id>||int||Use the item_id of the serveritem you want to order as a key and the quantity of the server as the value eg. '11716' => '1' (order one server with the item_id '11716')
+|-
+|accept_terms_and_conditions||bool||Set this flag to accept the terms and conditions(0 = NO, 1= YES). If you don't accept the terms and conditions, you can't order server. The terms and conditions can be found here:<br>http://euserv.de/unternehmen/agb.php
+|-
+|accept_special_terms_and_conditions_rootserver||bool||Set this flag to accept the spezial terms and conditions rootserver(0 = NO, 1= YES). If you don't accept the spezial terms and conditions rootserver, you can't order server. The spezial terms and conditions rootserver can be found here:<br>http://euserv.de/produkte/server/tosfdrs.php
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|total_amount||string||The total amount for the server you have ordered
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||can not load customer_id||Error while loading the customer_id from api-user. Please contact the support!
+|-
+|1002||can not load a_id||Error while laoding the as_id from api-user. Please contact the support!
+|-
+|1003||terms and conditions must be accepted||To order server you must accept the terms and conditions.
+|-
+|1004||special terms and conditions rootserver must be accepted||To order server you must accept the spezial terms and conditions rootserver.
+|-
+|1005||internal error||Internal error. Please contact the support!
+|-
+|1006||no items found||No items found. Please check your request.
+|-
+|1007||internal error||Internal error. Please contact the support!
+|-
+|1008||invalid item_id found||One of your item-ids is invalid. Please check your request.
+|-
+|1009||internal error||Internal error. Please contact the support!
+|-
+|1010||this function is only available for reseller||You are not a reseller, you can not use this function.
+|}
+====PHP EXAMPLE ====
+[[API Documentation RunningExamples server.order_server PHP]]
+=== server.get_traffic_graph ===
+----
+==== PURPOSE ====
+This method is used to get a traffic-graph for your server.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srv_id||int||The id of the server for which you want to get a traffic-graph.
+|-
+|graph_mode(optional)||int||The mode of the graph you want to get (0 = LAST DAY, 1 = LAST WEEK,2 = LAST MONTH,3 = LAST YEAR).
+|-
+|graph_language(optional)||string||The language of the graph you want to get (ISO Country Code, lower case). Possible types are 'en', 'de'. Default is 'en'.
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|traffic_graph||string||The base64 encoded data of the graph you want to get.
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||srv_id not given||The srv_id was not given.
+|-
+|1002||srv_graph_mode not valid||The given srv_graph_mode is not valid.
+|-
+|1003||can not load portdata||Cannot load portdata, please contact the support!
+|-
+|1004||can not load portdata||Cannot load portdata, please contact the support!
+|-
+|1005||can not load portdata||Cannot load portdata, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples server.get_traffic_graph PHP]]
+=== server.get_traffic ===
+----
+==== PURPOSE ====
+This method reads the traffic of the submitted srvord_id and returns this.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|srvord_id||int||The srvord_id od the desired server.
+|-
+|startdate(optional)||string||The startdate, format YYYY-mm-dd, if start date and end date are not specified the actual month is shown.
+|-
+|enddate(optional)||string||The end date, format YYYY-mm-dd, if start date and end date are not specified the actual month is shown.
+|-
+|date_format(optional)||string||The format in which the date should be issued, DEFAULT YYYY-mm-dd, details: HERE
+|-
+|unit_type(optional)||int||The desired unit in which all be returned, possible values 1 = Kilobyte, 2 = Megabyte, 3 = Gigabyte, DEFAULT byte
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|status||int||100 (everything ok - traffic has been read)
+|-
+|traffic_data||array_asoc||A href of traffic data in which element ID is a sequential number (start = 0, end = traffic_data_count - 1)
+|-
+|traffic_data_count||int||The number of elements in traffic_data
+|-
+|traffic_sum||float||The number of the traffic over the desired period of time
+|}
+==== traffic_data – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|Element ID||array_asoc||the id of the element in the array
+|}
+==== traffic_data – Keys of third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|date||string||The date of the entry in the desired format
+|-
+|in||float||the incoming traffic in the desired format
+|-
+|out||float||the outgoing traffic in the desired format
+|-
+|sum||float||the entire traffic in the desired format
+|}
+== Domain-related Methods ==
+=== domain.get_domain_orders ===
+----
+==== PURPOSE ====
+This method is used to give you an overview of your domain orders an their features.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_orders||array asoc ||Contains domain order data
+|}
+==== Keys of the second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<order_id> || array asoc ||Contains domain order data
+|}
+==== Key of the third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_id||int||The id of the current domain.
+|-
+|domain_name||string||The name of the current domain.
+|-
+|domain_name_idn||string||The name idn of the current domain.
+|-
+|feature_redirect||int||Tells you, if the redirect feature is disabled or enabled(0/1).
+|-
+|feature_dns||int||Tells you, if the redirect feature is disabled or enabled(0/1).
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||can not load customer data||Error while loading the customer data. Please contact the support!
+|-
+|1002||no domain orders found||No domain orders can be found.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.get_domain_orders PHP]]
+=== domain.get_domain_order_details ===
+----
+==== PURPOSE ====
+This method is used to get the details of the domain order.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_id||int||The order id of that order you want to see the details.
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_order_details||array asoc||Contains domain order details.
+|}
+==== domain_order_details - Keys of the second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_id||array asoc||Contains domain order details.
+|}
+==== <order_id> - Keys of the third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_status||int||The current order status(1 = ready, 3 = in process, 11 = transfer in process, 12 = waiting)
+|-
+|domain_id||int||The domain id of the current domain.
+|-
+|domain_name||string||The domain name of the current domain.
+|-
+|domain_name_idn||string||The domain name of the current domain.
+|-
+|dns_record_type||array asoc||An array asoc of available dns record types and there data .(A, AAAA, MX, AFSDB, CERT, CNAME, DNSKEY, DS, HINFO, KEY, LOC, NAPTR, NSEC, RP, RRSIG, SPF, SSHFP, SRV, TXT)
+|-
+|redirect_record_type||array asoc||An array asoc of available redirect record types(frameredirect, headerredirect)
+|-
+|redirect_record_max||int||The maximum of redirect records you can create.
+|-
+|redirect_record_used||int||The count of used redirect records.
+|-
+|redirect_record_free||int||The count of free redirect records.
+|}
+==== dns_record_type - Keys of the fourth dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<dns_record_type>||array asoc||An array asoc of the current dns record type data.
+|}
+==== <dns_record_type> - Keys of the fifth dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_record_max||int||The maximum of dns records you can create.
+|-
+|dns_record_used||int||The count of dns records you have already used.
+|-
+|dns_record_free||int||The count of free dns records.
+|}
+==== redirect_record_type – Keys of the fourth dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<redirect_record_type>||int||A flag that tells you if the redirect_record_type is available.
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||order_id is invalid||The given order id is invalid
+|-
+|1002||order_id is not managed by api user||The given order id is not managed by you
+|-
+|1003||domain order not found||The given domain order was not found.
+|-
+|1004||internal error||Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExample domain.get_domain_order_details PHP]]
+=== domain.dns_create_record ===
+----
+==== PURPOSE ====
+This method is used to create an dns record for your domain.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_id||int||The domain id of the domain you want to create a dns record.
+|-
+|dns_record_subdomain (optional)||string||The subdomain of the dns record you want to create.
+|-
+|dns_record_type||string||The type of the dns record you want to create. Possible Types are A, AAAA, MX, AFSDB, CERT, CNAME, DNSKEY, DS, HINFO, KEY, LOC, NAPTR, NSEC, RP, RRSIG, SPF, SSHFP, SRV, TXT
+|-
+|dns_record_value||string||The value of the dns record you want to create ( e.g euserv.de).
+|-
+|dns_record_prio (optional)||int||The record prio of the dns record you want to create(only essential for mx records).
+|-
+|dns_record_ttl||int||The ttl of the dns record you want to create. At least 43200.
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_record_id||int||The id of the dns record you have created.
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||domain_id not given||The domain_id was not given.
+|-
+|1002||dns_record_subdomain invalid||The given dns_record_subdomain is invalid.
+|-
+|1003||dns_record_type not given||The dns_record_type was not given.
+|-
+|1004||dns_record_type not valid||The given dns_record_type is not valid.
+|-
+|1005||dns_record_value not given||The dns_record_value was not given.
+|-
+|1006||dns_record_value not valid||The given dns_record_value is not valid.
+|-
+|1007||dns_record_prio not given||You want to create an mx record and no dns_record_prio was given.
+|-
+|1008||dns_record_ttl not given or to low||The dns_record_ttl was not given or lower then 43200.
+|-
+|1009||domain not found ||There are no domain found for domain_id.
+|-
+|1010||order not ready||The domain order is not ready so you can't create dns records.
+|-
+|1011||domain not managed by customer||The domain of the given domain_id was not managed by you.
+|-
+|1012||internal error||Internal error, please contact the support!
+|-
+|1013||can not load domain data||Cannot load domain data, please contact the support!
+|-
+|1014||internal error||Cannot load domain data, please contact the support!
+|-
+|1015||dns_record_type not possible in this order||The given dns_record_type is not available in your domain order.
+|-
+|1016||dns_record limit reached||The dns record limit has been reached.
+|-
+|1017||internal error||Internal error, please contact the support!
+|-
+|1018||dns_record already exits||The dns record you want to create already exits.
+|-
+|1019||internal error||Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.dns_create_record PHP]]
+=== domain.dns_delete_record ===
+----
+==== PURPOSE ====
+This method is used create a dns record of your domain.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_record_id || int||The id of the dns record you want to delete.
+|}
+==== RETURNS ====
+Only 'status' = '100' if request was accepted.
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||customer_id not given||Internal error, please contact the support!
+|-
+|1002||dns_record_id not given||There are no dns_record_id given.
+|-
+|1003||dns_record not found||No dns record found for dns_record_id.
+|-
+|1004||order not ready||The order of the dns_record_id is not ready.
+|-
+|1005||dns_record not managed by customer||The dns record is not managed by you.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.dns_delete_record PHP]]
+=== domain.dns_update_record ===
+----
+==== PURPOSE ====
+This method is used to update a dns record for your domain.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_record_id||int||The id of the dns record you want to update.
+|-
+|dns_record_value(optional)||string||The new dns record value of the dns record you want to update
+|-
+|dns_record_prio(optional)||int||The new prio of the dns_record you want to update (only essential for mx records).
+|-
+|dns_record_ttl(optional)||int||The new ttl of the dns record you want to update. At least 43200.
+|}
+==== RETURNS ====
+Only 'status' = '100' if request was accepted.
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||nothing to do||There is nothing to do! You send an empty request.
+|-
+|1002||dns_record_id not given||The dns_record_id was not given.
+|-
+|1003||dns_record_id not valid||The given dns_record_id is not valid.
+|-
+|1004||internal error||Internal error, please contact the support!
+|-
+|1005||dns_record_type not valid||Internal error, please contact the support!
+|-
+|1006||dns_record_value not valid||The given dns_record_value is not valid.
+|-
+|1007||dns_record_type not accept dns_record_prio||You send dns_record_prio but the current dns_record_type does not accept dns_record_prio.
+|-
+|1008||dns_record_ttl to low||The given dns_record_ttl is lower 43200.
+|-
+|1009||dns_record not found||No dns record found for dns_record_id.
+|-
+|1010||order not ready||The Domainorder is not in the status 'ready'.
+|-
+|1011||dns_record not managed by customer||The dns_record of the given dns_record_id is not managed by you.
+|-
+|1012||internal error||Internal error, please contact the support!
+|-
+|1013||internal error||Internal error, please contact the support!
+|-
+|1014||internal error||Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.dns_update_record PHP]]
+=== domain.dns_get_active_records ===
+----
+==== PURPOSE ====
+This method is used to show all activ dns records.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_id||int||The domain_id of the domain for which you want to see all the dns records.
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_records||array asoc||An array asoc of all activ dns records for your domain.
+|}
+==== dns_records - Keys of the second dimension. ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<dns_record_id>||array asoc||An array asoc with all data of the dns record.
+|}
+==== <dns_record_id> - Keys of the third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|dns_record_name||string||The full name of the current dns record.
+|-
+|dns_record_type||string||The type of the current dns record.
+|-
+|dns_record_content||string||The content of the current dns record.
+|-
+|dns_record_ttl||int||The ttl of the current dns record.
+|-
+|dns_record_prio||int||The prio of the current dns record(only on mx records).
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||customer_id not given||Internal error, please contact the support!
+|-
+|1002||domain_id not given||There is no domain_id given.
+|-
+|1003||domain not found||No domain found for domain_id.
+|-
+|1004||order not ready||The order of the domain_id is not ready.
+|-
+|1005||domain not managed by customer||domain not managed by customer
+|-
+|1006||no dns_record found||No dns records found for domain.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.dns_get_active_records PHP]]
+=== domain.redirect_create_record ===
+----
+==== PURPOSE ====
+This method is used to create a redirect record.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_id||int||The domain_id of the domain you want to create a redirect record for.
+|-
+|redirect_record_type||string||The type of redirect record you want to create. Possible types are frameredirect or headerredirect
+|-
+|redirect_record_subdomain (optional)||string||The subdomain of the redirect record you want to create.
+|-
+|redirect_record_location||string||The location of the redirect_record. Only URL start with http:// OR https://).
+|-
+|redirect_record_status_code (optional)||int||An webserver status code that describes the type of redirection(Only for redirect_record_type headerredirect). Available codes are 301, 302 and 307.
+|-
+|redirect_record_title (optional)||string||The title of your redirect record (Only for frameredirect).
+|-
+|redirect_record_description (optional)||string||The description of you redirect record (Only for frameredirect).
+|-
+|redirect_record_author (optional)||string||The description of you redirect record (Only for frameredirect).
+|-
+|redirect_record_keywords (optional)||string||The keywords of your redirect record (Only for frameredirect).
+|-
+|redirect_record_robots (optional)||string||The robot description of your redirect_record (Only for frameredirect).
+|-
+|redirect_record_favicon (optional)||string||The favicon url of your redirect_record (Only for frameredirect).
+|}
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|redirect_record_id||int||The id of the redirect record you have created.
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||domain_id not given||The domain_id was not given.
+|-
+|1002||redirect_record_type not given||The redirect_record_type was not given
+|-
+|1003||parameter redirect_record_title, redirect_record_description, redirect_record_author, redirect_record_keywords, redirect_record_robots, redirect_record_favicon not available for redirect_record_type||You send invalid parameter for headerredirect.
+|-
+|1004||redirect_record_location not given||The redirect_record_location was not given.
+|-
+|1005||redirect_record_status_code not given||The redirect_record_status_code was not given.
+|-
+|1006||parameter redirect_record_status_code not available for redirect_record_type||You send invalid parameter for frameredirect.
+|-
+|1007||redirect_record_location not valid||The given redirect_record_location is not valid.
+|-
+|1008||domain not found||No domain found for domain_id.
+|-
+|1009||order not ready||The domain order is not ready so you cannot create redirect records.
+|-
+|1010||domain not managed by customer||The domain of the given domain_id was not managed by you.
+|-
+|1011||internal error||Internal error, please contact the support!
+|-
+|1012||internal error||Internal error, please contact the support!
+|-
+|1013||internal error||Internal error, please contact the support!
+|-
+|1014||redirect is not available||The redirect feature is not available for this domain.
+|-
+|1015||<redirect_record_type> is not available||<redirect_record_type> is not available in this order.
+|-
+|1016||redirect limit reached||The redirect limit has reached.
+|-
+|1017||redirect_record_wildcard is not available||You want to set an wildcard and wildcard is not available for your order.
+|-
+|1018||internal error||Internal error, please contact the support!
+|-
+|1019||redirect_record already exits||The redirect record you want to create already exits.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.redirect_create_record PHP]]
+===domain.redirect_delete_record===
+----
+====PURPOSE====
+This method is used to delete a redirect record.
+====CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|redirect_record_id||int||The id of the redirect record you want to delete.
+|}
+==== RETURNS ====
+Only 'status' = '100' if request was accepted.
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||customer_id not given||Internal error, please contact the support!
+|-
+|1002||redirect_record_id not given||Internal error, please contact the support!
+|-
+|1003||redirect_record not found||No redirect record found for redirect_record id.
+|-
+|1004||order not ready||The order of the redirect record id is not ready.
+|-
+|1005||redirect_record not managed by customer||The redirect record is not managed by you.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.redirect_delete_record PHP]]
+=== domain.redirect_update_record ===
+----
+==== PURPOSE ====
+This method is used to update a redirect record.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|redirect_record_id||int||The id of the redirect record you want to update.
+|-
+|redirect_record_location (optional)||string||The location of the redirect record you want to update. Only URL start with http:// OR https://).
+|-
+|redirect_record_status_code (optional)||int||An webserver status code that describes the type of redirection (Only for redirect_record_type headerredirect). Available codes are 301, 302 and 307.
+|-
+|redirect_record_title (optional)||string||The title of your redirect record (Only for frameredirect).
+|-
+|redirect_record_description (optional)||string||The description of you redirect record (Only for frameredirect).
+|-
+|redirect_record_author (optional)||string||The description of you redirect record (Only for frameredirect).
+|-
+|redirect_record_keywords (optional)||string||The robots description of your redirect_record (Only for frameredirect).
+|-
+|redirect_record_favicon (optional)||string||The favicon url of your redirect_record (Only for frameredirect).
+|}
+==== RETURNS ====
+Only 'status' = '100' if request was accepted.
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001||redirect_record_id not given ||The redirect_record_id was not given.
+|-
+|1002 ||redirect_record not found ||No redirect record found for redirect_record id.
+|-
+|1003 ||order not ready ||The order of the redirect record id is not ready.
+|-
+|1004 || redirect_record not managed by customer ||The redirect record is not managed by you.
+|-
+|1005 ||internal error ||Internal error, please contact the support!
+|-
+|1006 ||internal error ||Internal error, please contact the support!
+|-
+|1007 ||redirect_record_type not valid ||Internal error, please contact the support!
+|-
+|1008 ||parameter redirect_record_title, redirect_record_description, redirect_record_author, redirect_record_keywords, redirect_record_robots, redirect_record_favicon not available for redirect_record_type || The current redirect record is a headerredirect and you send invalid parameter.
+|-
+|1009 ||nothing to do|| There is nothing to do.
+|-
+|1010 ||parameter redirect_record_status_code not available for redirect_record_type||The current redirect record is a frameredirect and you send invalid parameter.
+|-
+|1011 || nothing to do ||There is nothing to do.
+|-
+|1012 ||internal error ||Internal error, please contact the support!
+|-
+|1013 || internal error || Internal error,please contact the support!
+|}
+====PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.redirect_update_record PHP]]
+=== domain.redirect_get_active_records ===
+----
+==== PURPOSE ====
+This method is used to show all activ redirect records.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_id ||int||The domain_id of the domain for which you want to see all the redirect records.
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|redirect_records||array asoc||An array asoc of all activ redirect records for your domain.
+|}
+==== redirect_records - Keys of the second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<redirect_record_id>||array asoc||An array asoc with all data of the redirect record.
+|}
+==== <redirect_record_id> - Keys of the third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|redirect_record_type||string||The type of the current redirect record.
+|-
+|redirect_record_status_code|| int|| The Webserver status code of the current redirect record. (only on headerredirect records)
+|-
+|redirect_record_name|| string || The name of the current redirect record.
+|-
+|redirect_record_location ||string|| The location of the current redirect record.
+|-
+|redirect_record_title || string || The title of the current redirect record (only on frameredirect records).
+|-
+|redirect_record_description || string || The description of the current redirect record (only on frameredirect records).
+|-
+|redirect_record_author ||string|| The author of the current redirect record (only on frameredirect records).
+|-
+|redirect_record_keywords ||string|| The keywords of the current redirect record (only on frameredirect records).
+|-
+|redirect_record_robots|| string ||The robots description of the current redirect record (only on frameredirect records).
+|-
+|redirect_record_favicon ||string ||The favicon url of the current redirect record (only on frameredirect records).
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001 ||customer_id not given|| Internal error, please contact the support!
+|-
+|1002 ||domain_id not given|| There is no domain_id given.
+|-
+|1003 || domain not found || No domain found for domain id.
+|-
+|1004 || order not ready || The order of the domain id is not ready.
+|-
+|1005 ||domain not managed by customer|| The domain is not managed by you.
+|-
+|1006 || no redirect records found || No redirect records found for domain.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.redirect_get_active_records PHP]]
+=== domain.check ===
+----
+==== PURPOSE ====
+This method is used for a short check if the domain is available.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|domain_name ||string||The name of the domain you want to check.
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|is_available||int||0(domain is not available) or 1 (domain is available)
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples domain.check PHP]]
+== Order-related Methods ==
+=== order_external.get_possible_items ===
+----
+==== PURPOSE ====
+This method is used to get a list of items that can be ordered.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|item_group ||string||The item group you want to show. Possible item groups are server, vserver, cloud, hosting, mail or domain.
+|-
+|item_name_regexp (optional) ||string|| A regex to limit the result by item_name
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|item_list||array asoc||A list of all possible items.
+|-
+|item_list_count||int||The count of the itemlist .
+|}
+==== item_list - Keys of the second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|<item_list_id>||array asoc||An array asoc with all data of the item.
+|}
+==== <item_list_id> - Keys of the third dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|item_id||int||The id of the item.
+|-
+|item_name|| string|| The name of the item.
+|-
+|item_billing_period|| int || The billing period of the item.
+|-
+|item_contract_period|| int || The contract period of the item.
+|-
+|item_mrc||string|| Monthly recurring costs of the item.
+|-
+|item_nrc|| string ||  Non recurring costs of the item.
+|-
+|item_nrc_sale|| string ||  Non recurring costs of the item if sale is active(only present if sale is active for this item).
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001 ||internal error|| Internal error, please contact the support!
+|-
+|1002 ||item_group not given|| There is no item group given.
+|-
+|1003 ||item_group invalid|| The item group is not valid.
+|-
+|101004 ||pg_id invalid|| Internal error, please contact the support!
+|-
+|101005 ||can not load data|| Item data can not be load.
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples order_external.get_possible_items PHP]]
+=== order_external.create_order ===
+----
+==== PURPOSE ====
+This method is used for to create orders.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|item_id ||int||The item id of your destination item.
+|-
+|domain_name (optional) ||string||The domain name for your order need for item group domain, hosting and mail.
+|-
+|domain_authcode (optional) ||string||The authcode for your domain if your domain is not free.
+|}
+====RETURNS====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|total_amount_formatted||string||The amount of your order in format '0,00'.
+|-
+|total_amount||float||The amount of your order in float format ('0.00').
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001 ||internal error|| Internal error, please contact the support!
+|-
+|1002 ||tac not accepted|| Tac not accepted, please accept tac!
+|-
+|1003 ||item_id not given|| The item id has not been given!
+|-
+|1004 ||item_id invalid|| The item id is invalid.
+|-
+|1005 ||item_id invalid|| The item id is invalid.
+|-
+|1006 ||item_id invalid|| The item id is invalid.
+|-
+|1007 ||item_id invalid|| The item id is invalid.
+|-
+|1008 ||item_id invalid|| The item id is invalid.
+|-
+|1009 ||internal error|| Internal error, please contact the support!
+|-
+|1010 ||domain_name not given|| Domain name needed but not given.
+|-
+|1011 ||domain_name invalid|| Domain name is not valid.
+|-
+|1012 ||domain_name not possible for item_id|| Domain name is not valid for this item id.
+|-
+|1013 ||domain_name invalid|| Domain name is not valid.
+|-
+|1014 ||internal error|| Internal error, please contact the support!
+|-
+|1015 ||internal error|| Internal error, please contact the support!
+|-
+|1016 ||domain_authcode not given|| Domain authcode needed but not given.
+|-
+|1017 ||internal error|| Internal error, please contact the support!
+|-
+|1018 ||internal error|| Internal error, please contact the support!
+|-
+|1019 ||internal error|| Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API Documentation RunningExamples order external.create_order PHP]]
+== vServer-related Methods ==
+=== vserver.list_vservers ===
+----
+==== PURPOSE ====
+This Method is used to get all manageable vServers and basic details for further method calls. Only these vServers which are manageable by the used API user will be returned.
+==== CALL PARAMETERS ====
+N/A
+==== RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|vserver_list_count||int||Number (amount) of available vservers
+|-
+|vserver_list_data||array asoc||Contains basic vserver details in a multidimensional, associative array. Keys of the first dimension equals the vserver order numbers: e.g. $array ['123456'] Values are contained in the second dimension: e.g. $array ['12345'] ['vsrv_main_ip'] returns the main
+|}
+==== vserver_list_data – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_desc||string||Description/Product name
+|-
+|vsrvord_id||int||vServer’s unique ID (required for further method calls)
+|-
+|vsrv_main_ip||string||Primary IP address
+|-
+|vsrv_name||string||vServer name (for network settings)
+|-
+|status||string enum||vServer or order status:<br> - “ready” means vserver can be used<br> - “in_rescue” means vserver can be used but it’s currently in rescue mode<br> - “in_process” means vserver is not available at present<br> - “locked” means vserver/order is locked by the provider
+|}
+==== PHP EXAMPLE ====
+[[API_Documentation_RunningExamples_vserver.list_vservers_PHP]]
+=== vserver.get_details ===
+----
+==== PURPOSE ====
+This Method is used to get all details of a manageable vserver. Only these vservers are available, which are manageable by the used API.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|vsrvord_id||int||vServer's unique ID
+|}
+====RETURNS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|vserver_details||array (asoc)||Contains all vserver details in an associative array
+|}
+==== vserver_details – Keys of second dimension ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|order_no||int||vServer contract’s order number
+|-
+|order_desc||string||Description/Product name
+|-
+|vsrvord_id||int||vServer’s unique ID (required for further method calls)
+|-
+|vsrv_main_ip||string||Primary IP address
+|-
+|vsrv_name||string||vServer name (for network settings)
+|-
+|vsrv_name_reverse||string||vServer reversename (for network settings)
+|-
+|vsrv_netmask||string||Netmask for network / IP address setup
+|-
+|vsrv_broadcast||string||Broadcast address for network / IP address setup
+|-
+|vsrv_gateway||string||Gateway address for network / IP address setup
+|-
+|vsrv_status||string enum || vServer or order status:<br>- “ready” means vserver can be used <br> - “in_rescue” means vserver is currently in rescue mode<br> - “in_process” means vserver is not available at present<br>- “locked” means vserver/order is locked by the provider
+|-
+|vsrv_default_pw||string||Default password for initial login or rescue usage
+|-
+|vsrv_os_id||int||ID of currently used OS image (for reinstall)
+|-
+|vsrv_os_name||string||Name/description of currently used OS image
+|-
+|vsrv_os_is_64bit||bool||OS image 64bit support (true or false)
+|}
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1002 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1003 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1004 ||vsrvord_id not assigned to customer|| The vsrvord_id is not assigned to your customer account.
+|-
+|1005 ||internal error|| Internal error, please contact the support!
+|-
+|1006 ||internal error|| Internal error, please contact the support!
+|-
+|1007 ||internal error|| Internal error, please contact the support!
+|-
+|1008 ||internal error|| Internal error, please contact the support!
+|-
+|1009 ||internal error|| Internal error, please contact the support!
+|-
+|1010 ||internal error|| Internal error, please contact the support!
+|-
+|1011 ||internal error|| Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API_Documentation_RunningExamples_vserver.get_details_PHP]]
+=== vserver.reset ===
+----
+==== PURPOSE ====
+This Method is used to perform a vserver reset.
+==== CALL PARAMETERS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Field / Key Name''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Type''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|vsrvord_id||int||vServer’s unique ID
+|}
+====RETURNS====
+Only “status” = “100” if request was accepted
+==== METHOD ERRORS ====
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|-
+|width="25%" style="background-color:rgb(230,230,230)"|'''Code''' ||width="25%" style="background-color:rgb(230,230,230)"|'''Short Message''' ||width="50%" style="background-color:rgb(230,230,230)"| '''Description'''
+|-
+|1001 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1002 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1003 ||vsrvord_id not valid|| The vsrvord_id is not valid.
+|-
+|1004 ||vsrvord_id not assigned to customer|| The vsrvord_id is not valid.
+|-
+|1005 ||internal error|| Internal error, please contact the support!
+|-
+|1006 ||internal error|| Internal error, please contact the support!
+|-
+|1007 ||internal error|| Internal error, please contact the support!
+|-
+|1008 ||internal error|| Internal error, please contact the support!
+|-
+|1009 ||internal error|| Internal error, please contact the support!
+|-
+|1010 ||internal error|| Internal error, please contact the support!
+|-
+|1011 ||internal error|| Internal error, please contact the support!
+|}
+==== PHP EXAMPLE ====
+[[API_Documentation_RunningExamples_vserver.reset_PHP]]
+= XML Fault-Codes (Error Messages) =
+----
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|colspan="3" style="background-color:rgb(230,230,230)"|
+==Internal Errors ==
+|-
+|width="25%"|'''Code''' ||width="25%"|'''Short Message''' ||width="50%"| '''Description'''
+|-
+|10001 ||Service temporary not available ||Service temporary not available. Try again later.
+|-
+|10021 ||Internal database error ||Error while connecting to internal database. Please contact the support!
+|-
+|10022 ||Internal database error ||Error while execute SQL-Query. Please contact the support!
+|-
+|10041 ||No such method: <method name> ||The requested method does not exist.
+|-
+|10042 ||Method temporary locked: <method name> ||The requested method is locked at present. Try again later.
+|-
+|10043 ||Internal error in method: <method name>||No return from called method. Please contact the support!
+|-
+|10044|| Internal error in method: <method name>||<Method returned an (internal) error.
+|}
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|colspan="3" style="background-color:rgb(230,230,230)"|
+== Request Errors / Sanity Check Errors ==
+|-
+|width="25%"|'''Code''' ||width="25%"|'''Short Message''' ||width="50%"| '''Description'''
+|-
+|10002 ||Wrong HTTP-Header ||HTTP-Header error: No 'method' declared
+|-
+|10003 ||Wrong HTTP-Header ||HTTP-Header error: 'method' must be 'POST'
+|-
+|10004 ||Wrong HTTP-Header ||HTTP-Header error: No 'contenttype' declared
+|-
+|10005 ||Wrong HTTP-Header ||HTTP-Header error: 'contenttype' must be 'text/xml'
+|-
+|10006 ||Wrong HTTP-Header ||HTTP-Header error: 'contentlength' required
+|-
+|10007 ||Wrong HTTP-Header ||HTTP-Header error: 'contentlength' cannot be zero
+|-
+|10008 ||Request error: length mismatch ||Length of request does not match with notation in header. See 'content-length' in header.
+|-
+|10009 ||Request is too large|| Exceeding of maximum request length
+|-
+|10010 ||Missing required parameter: <parameter> ||Given parameter is required by called method but it is missing.
+|-
+|10011 ||Wrong parameter format: <parameter>||Given parameter is in a wrong format. Please check api documentation.
+|-
+|10012 ||Unknown value for parameter <param> : <value> ||Given value for mentioned key is unknown or incorrect. Maybe a typo?
+|-
+|10013|| Unknown parameter: <parameter>||Given parameter is unknown. Maybe a typo?
+|}
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|colspan="3" style="background-color:rgb(230,230,230)"|
+== Authentication Errors ==
+|-
+|width="25%"|'''Code''' ||width="25%"|'''Short Message''' ||width="50%"| '''Description'''
+|-
+|10031 ||Authentication failed ||Authentication failed: empty username
+|-
+|10032 ||Authentication failed ||Authentication failed: empty passphrase
+|-
+|10033 ||Authentication failed ||Authentication failed: no such user / wrong password / account locked / no permission
+|-
+|10034 ||Authentication failed ||IP address restriction: remote address does not match.
+|-
+|10035 ||Authentication failed ||Error in user accounting settings, no main account specified. Please contact support.
+|-
+|10036 ||Authentication failed ||Responsible management account is locked.
+|-
+|10039 ||Permission denied. ||User has no permission for called method.
+|}
+{|width="100%" style="border-color:rgb(230,230,230); background-color:white;" cellpadding="5" cellspacing="0" border="2px solid"
+|colspan="3" style="background-color:rgb(230,230,230)"|
+== API User-Management Errors ==
+|-
+|width="25%"|'''Code''' ||width="25%"|'''Short Message''' ||width="50%"| '''Description'''
+|-
+|11001 ||Name/ID not available ||Provided acc_sub_id is not available for creation or already exists.
+|-
+|11002 ||Internal error while creating subaccount.|| Internal error, please contact support.
+|-
+|11003 ||No permission for group <group>|| Main account has no permission for mentioned group.
+|-
+|11006 ||Max. user accounts reached ||Unable to create a new user account due max. user account restriction. Please contact support for further capability!
+|-
+|11010 ||Unable to modify account: <acc_id>||Provided acc_sub_id does not exist or permission was denied.
+|}

Ansichten

Persönliche Werkzeuge

Navigation

Werkzeuge

API Documentation/en

Aus EUserv Wiki

Aktuelle Version vom 09:08, 11. Sep. 2019

Inhaltsverzeichnis

EUserv Reseller API

Introduction

Technology

API Servers

PHP Examples

History of Changes

Method Specifications

Introduction

API Debug/Testing Methods

debug.get_api_version

PURPOSE

CALL PARAMETERS

RETURNS

PHP EXAMPLE

debug.pingpong

PURPOSE

CALL PARAMETERS

RETURNS

PHP EXAMPLE

API User-Management Methods

usermngt.create_acc

PURPOSE

CALL PARAMETERS

RETURNS

usermngt.modify_acc

PURPOSE

CALL PARAMETERS

RETURNS

usermngt.list_acc

PURPOSE

CALL PARAMETERS

RETURNS

acc_list_data – Keys of second dimension

Server-related Methods

server.list_servers

PURPOSE

CALL PARAMETERS

RETURNS

server_list_data – Keys of second dimension

PHP EXAMPLE

server.get_details

PURPOSE

CALL PARAMETERS

RETURNS

server_details – Keys of second dimension

PHP EXAMPLE

server.get_possible_failover_servers

PURPOSE

CALL PARAMETERS

RETURNS

failover_server_list – Keys of second dimension

METHOD ERRORS

PHP EXAMPLE

server.get_possible_os_images

PURPOSE

CALL PARAMETERS

RETURNS

os_images_asoc_array – Keys of second dimension

PHP EXAMPLE

server.reset

PURPOSE

CALL PARAMETERS

RETURNS

PHP EXAMPLE

server.autoreinstall

PURPOSE

CALL PARAMETERS

RETURNS

PHP EXAMPLE

server.rescue_activate

PURPOSE

CALL PARAMETERS