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.
GET /api/dynamic/update.php?hostname=home.example.com&ip=10.1.1.1 HTTP/1.0 Host: control.dnspark.com Authorization: Basic username:password User-Agent: clientname/1.0 email@example.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 spaces, but there should not be in the actual URL.
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.
Dynamic Update Response Codes
Normal Result Codes
ok - The update was successful.
nochange - No changes were made to the hostname(s). Continual updates with no changes will lead to blocked clients.
Input Error Result Codes
nofqdn - No valid FQDN (fully qualified domain name) was specified.
nohost - An invalid hostname was specified. This due to the fact the hostname has not been created in the system. Creating new host names via dynamic DNS clients is not supported.
abuse - The hostname specified has been blocked for abuse. System Error Result Codes
unauth - The username specified is not authorized to update this hostname and domain.
blocked - The dynamic update client (specified by the user-agent) has been blocked from the system.
notdyn - The hostname specified has not been marked as a dynamic host. Hosts must be marked as dynamic in the system in order to be updated via clients. This prevents unwanted or accidental updates.
invalid - The IP address was provided in an invalid format. An IPv4 address was provided when updating an IPv6 ddns host, or vice versa. Otherwise, the address format was incorrect.