Dynamic DNS

Documentation

To make Dynamic Updates, calls need to be formulated using either http/httpS or a dynamic DNS client. The necessary arguments you need to pass are:

username – The username you use to log into DNS Made Easy.

password – The password you use to log into DNS Made Easy (or per record password if configured).

id- The unique ID for your record.

ip – The new IP for your record.

All arguments are required to make a successful call. From the DNS – Managed DNS menu, you can select a record and edit it to turn on Dynamic DNS and an option to set a password per record so you do not have to use your main DMS Made Easy password/username. DNS Made Easy uses the "record ID" so you are able to update any A record that you have in the system. In fact, you can update a backup IP in your DNS failover configuration or even one of your A records in your "round-robin" configuration. You can even update more than one ID at a time when you separate them by commas (,). You can view the record ID's for A records with DNS Failover on the DNS Failover configuration screen. These are the record ID's you would use to configure DDNS updates for your failover IPs.

Dynamic DNS Technical Specification Page to create a client for DDNS

All updates are made through a servlet. You must analyze the data that is sent back to you. The page (servlet) returns a string.

Here is the rundown:

The servlet is: https://cp.dnsmadeeasy.com/servlet/updateip?

You can also use http: http://cp.dnsmadeeasy.com/servlet/updateip?

Each DNS Made Easy user has four pieces of information they need to provide:

username (which is usually the users email account they use to log into DNS Made Easy)

password

record ID (Starting in 12/2003: separated by commas if more than one at a time)

ip – The new IP for your record.

The client will usually add the new IP

There are 4 parameters that you can pass in a POST or GET request to the following URL:

https://cp.dnsmadeeasy.com/servlet/updateip

The four parameters are: "username", "password", "id", and "ip".

NOTE: That if your password does have special characters that you may have to convert them to HEX first.
https://en.wikipedia.org/wiki/ASCII

An example would be:

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007&ip=12.13.14.15

OR (Starting in December of 2003)

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007,1008,1009&ip=12.13.14.15

You can also use just the HTTP protocol:

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007&ip=12.13.14.15

OR (Starting in December of 2003)

https://cp.dnsmadeeasy.com/servlet/updateip?username=test@example.com&password=mypass&id=1007,1008,1009&ip=12.13.14.15

Locate Your Record ID

Every record in DNS Made Easy is assigned a unique ID which is required as part of the call to pass in a dynamic update.

To locate your record ID:

Log In

Click the DNS – Managed DNS menu.

Select a domain and click on the Records tab

Double click a record

If the DDNS check box is not enabled, enable it. The Record ID is the Dynamic DNS ID on this page that appears below the check box.

Troubleshooting

• "error-auth" Invalid username or password, or invalid IP syntax
• "error-auth-suspend" User has had his / her account suspended. This is if I get complaints about them or if they misuse the service.
• "error-auth-voided" User has had his / her account revoked. Same thing as suspended but this is permanent.
• "error-record-invalid" Record does not exist in the system. / Unable to update record in system database.
• "error-record-auth" User does not have access to this record.
• "error-record-ip-same" IP never changed so nothing was done.
• "error-system" General system error which is caught and recognized by the system.
• "error" General system error unrecognized by the system.
• "success" The one and only good message.