Connect to the API

How to send requests to the API server

To communicate with our API server, post the XML code corresponding to the action you want to execute to a specific URL. This URL can either be the URL of our test environment or the URL of our production environment.

The XML code has to be encoded twice to contain only URL safe characters and must be sent using the HTML POST method. Please note that for security reasons, every request requires your authentication (login and password).

Send the password either in plain or MD5 format. If you send the password in MD5 format, it has to be preceded by the characters MD5 (For example: MD5A19f4d26e3c536b5dd871bb2c52e3178).

Please note that for security reasons the number of simultaneous requests to our API server is limited. Default limitations are 1 request per second with a burst limit of 10 requests. You may, therefore, either send 1 request each second or send 10 requests within a second and then wait 9 more seconds before sending another request. If you exceed these limitations, the API server will accept no more requests from your IP address and you will face HTTP 429 errors (Too Many Requests). In this case, please wait a couple of minutes before sending another request to our server. Be aware that the more you will exceed these limitations the more the blocking time will increase.

Test environment

We provide you a test environment to give you the possibility to test your scripts before launching them on the production server. The test server behaves exactly like the production server with the exception that all actions are free of charge and only simulated.

If you register for example a new domain on the test server, we will not forward this request to a registry and the domain will thus not be registered for real. To simulate the registration proces, the same domain will however be stated as taken if you check its availability on the test server.

Server Test Server
Web Interface: https://agent.tryout-eurodns.com/
API Interface: https://secure.tryout-eurodns.com:20015/v2/index.php
Production environment

As actions on the production server cannot be undone, it is highly recommended that you test your scripts on the test server before switching to the production environment. Please note that your login and your password may differ from one environment to the other.

We invite you to have a look at our PHP example of the API usage for an example how to switch easily between both environments.

Server Production Server
Web Interface: https://agent.api-eurodns.com
API Interface: https://secure.api-eurodns.com:20015/v2/index.php

Send a request using ...

  • ... the PEAR class HTTP_Request
  • ... only buildin functions
  • ... PHP cURL

Legend

O The element is optional and does not have to be specified in the request and/or answer
R The element is mandatory and has to specified in the request and/or answer