InternetBS / TopDNS DynDNS API Description

internetbs-topdns-dyndns.md

InternetBS / TopDNS DynDNS API Description

If you are using Linux, it is possible to use wget to update the IP. Here is a sample URL:

https://dyndns.topdns.com/update?hostname=www.example.com&username=myusername&password=mypassword

The above one will detect your IP automatically and perform the update. If you want to update with a custom IP address you can use:

https://dyndns.topdns.com/update?hostname=www.example.com&username=myusername&password=mypassword&myip=192.168.0.1

Note both URLs I gave you are using https but you can also use http however, for security reasons, we recommend using https.

Before using any of those you have to define the dynamic DNS host in the DNS management. To do this expand the the Dynamic DNS Records section and define the host you want to configure. The host name will be a subdomain of the domain but you can also have the domain itself or a wildcard. Then you will have to chose an Offline value and here you have 3 options:

1. Leave that field empty and if you set the host offline we will show a simple page stating the host is offline
2. Add an URL and if you set it offline we will redirect to that URL
3. add an ip and when you set the host offline our nameservers will return that ip address.

Here is an example URL to set the host offline:

https://dyndns.topdns.com/update?hostname=www.example.com&username=myusername&password=mypassword&offline=yes

I would like to point out that this is no longer working - I would assume as of Let's Encrypt's root certificate expiring on September 30 2021. The following error occurs:

ERROR: cannot verify dyndns.topdns.com's certificate, issued by ‘CN=R3,O=Let's Encrypt,C=US’:
  Unable to locally verify the issuer's authority.
To connect to dyndns.topdns.com insecurely, use `--no-check-certificate'.

I just wanted to update that despite letsencrypt failing, you can switch to http if you wish and keep using it (though your password will be transmitted in the clear)