Developers - Dynamic DNS Update Specifications

The basic premise to dynamic updates is sending a properly formatted HTTP URL to the DNS Park system. Once the request is sent, the response is read back from the update server and the user is notified of the status.

URL Specification

• Single Line

  https://username:passsword@www.dnspark.net/api/dynamic/ update.php?hostname=host1.mydomain.com, host2.otherdomain.org&ip=10.1.1.1&mx=ON&mxpri=5

• Multiple Lines

  GET /api/dynamic/update.php?hostname=host1.mydomain.com, host2.otherdomain.org&ip=10.1.1.1&mx=ON&mxpri=5 HTTP/1.0
  Host: www.dnspark.net
  Authorization: Basic username:password
  User-Agent: clientname/1.0 developer@clientweb.com

NOTICE: There should be no spaces in the single line query or the GET line of the multiple line query. On this page it may appear there are spaced, but there should not be in the actual URL.

Argument Definitions

username:password - For security purposes, each DNS Park user must create separate DDNS users from within their DNS Park account. DNS Park user accounts will not work for authenticating DDNS updates.

hostname - A list of the hostnames that are to be updated with a new IP address. Multiple hosts may be specified in a single update. Hostnames should be separated by a comma (,) when submitting.

ip - The new IP address the hostnames should be updated with. This argument is optional. If it is left blank, we will make our best guess as to the IP address of the system.

mx - This will set the new IP address and hostname as a valid mail exchanger (MX record). This should be set to either ON or OFF. This argument is optional. If it is left blank, we will assume that no mx record is to be set and a value of OFF.

mxpri - This will set the priority of the mail exchanger. The default value is 5. This argument is optional. If it is left blank, we will assume the default value if mx is specified.