Dynamic DNS Services
Our dynamic dns services work based on simple HTTP/HTTPS GET requests using dyndns2 protocol.
Clients
Several clients are available:
Protocol reference
You can request a host update using the next HTTP GET request:
curl 'http://youremail%40address.com:yourpassword@www.visualdns.net/nic/update?hostname=www.mydomain.com&myip=1.2.3.4' good
In this case youremail@address.com is used as username, but also your username can be used.
curl 'http://username:yourpassword@www.visualdns.net/nic/update?hostname=www.mydomain.com&myip=1.2.3.4' good
Supported parameters
The parameters can be a certain value, but also YES
,
NO
and nochg
to avoid changing that parameter.
-
hostname
is the A entry to be updated, it must be in your domain record listing. -
myip
is the IPv4 address that will be updated into your A record
Optional parameters
-
mx
must be a host name, where the mx record for your domain (highest priority) will be sent to, you can keep aditional MX records with lower priorities, that will be untouched -
backmx
must be a host name, where the mx record for your domain (second highest priority) will be sent to, you can keep aditional MX records with lower priorities, that will be untouched
Responses
HTTP result code will always be 200 / OK, and the following text results could be return
-
good
: The change is been done effectively -
nochg
: Everything ok, but nothing changed compared to our records. -
nohost
: The domain you're trying to update does not exist or does belong to a different account -
numhost
: There is no A record for the subdomain you're trying to update -
badauth
: Authentication parameters are wrong -
notfqdn
: malformed hostname. -
badip
: malformed IPv4 address. -
badparam
: bad parameter, can have the parameter after badparam.
Terms of service, abuse
IP updates must be only done when a real IP or MX change is done, sending the current IP repeatedly is not an acceptable method for IP updates, and it shall result in your account getting blocked for that reason.