DDNS documentation

Our DDNS Service emulates the DynDNS server protocol.


Generel

The following syntax can be used to call the DDNS Service.

https://api.unoeuro.com/ddns.php?apikey=[APIKEY]&domain=[DOMAIN]&hostname=[HOSTNAME]&myip=[IP]

Arguments

apikey The API key for the UnoEuro account. Found in our controlpanel.
domain The name of the domain (product) you wish to update. Can be in punycode format.
hostname The name of the A record you wish to update. The domain should not be appended to this. Ie. use "home", not "home.example.com".
myip Optional. The IP address of the DNS record. If this field is not the provided, the IP of the client is automatically used instead.

Responses

dnserr Something went wrong
nochg The record is already set to the IP given.
badauth Invalid login
good The record has been updated

Curl example Recommended

Use the following curl command:

# curl -s -L "https://api.unoeuro.com/ddns.php?apikey=[APIKEY]&domain=[DOMAIN]&hostname={hostname}"

Replace {hostname} with the name of the A record you wish to update.

Tip: You can set this command to run in a crontab, on a local machine, every 15 minutes or so.


Synology example

Go to "Control Panel" - "External Access" - "DDNS" and click "Customize".

Enter "UnoEuro" as "Service provider".

Enter this as "Query URL" and click "Save":

https://api.unoeuro.com/ddns.php?apikey=[APIKEY]&domain=[DOMAIN]&hostname=__HOSTNAME__&myip=__MYIP__

Next click "Add" and select "UnoEuro" from "Service provider" list.

You can fill the "Username" and "Password" fields with random stuff, it is not used for anything

Alternative method

You can also setup DDNS as a simple curl command using the "Task Scheduler" and a "User-defined script" that runs every 15 minutes.


Tomato firmware example

In Tomato firmware, choose "Custom URL" and enter the following:

https://api.unoeuro.com/ddns.php?apikey=[APIKEY]&domain=[DOMAIN]&hostname={hostname}&myip=@IP

Where {hostname} is replaced with the name of the A record you wish to update.


dd-wrt example

In dd-wrt choose "Custom" in the DDNS menu.

Enter something random in the "username" and "password" fields (The values are not used for anything).

Under "DYNDNS Server" enter "api.unoeuro.com".

In the "hostname" field, enter the name of the A record you wish to update.

Enter the following in the "URL" field:

/ddns.php?apikey=[APIKEY]&domain=[DOMAIN]&hostname=

Please note your dd-wrt has to support SSL (https), if it does not, then please use the curl example instead.