Affordable Bulk DNS Hosting Services

  

World Wide DNS Hosting Services

Sign-up Now!

DNS API PROTOCOL

This API is used for just updating 1 record in a zone file. It is a simpler version for those of you who don't need to adjust the SOA record data.

URL to call for DNS updates: https://www.worldwidedns.net/api_dns_modify_dynamic.asp

The above URL should be called with HTTPS for secure communications however you can use HTTP and use a non secure transaction.

The domain needs to already be in our servers in order for you to make an update. When you pass the data to our servers we will determine if the domain is a Dynamic domain or a Standard domain. We will also determine if it is a primary or secondary type based on how the domain was created on our servers. You have no control over the type of domain you are updating. Be sure the domain is setup on our servers accordingly.

Parameter Value Description
NAME login ID Your login ID
PASSWORD password Your password
DOMAIN domain name Domain name to modify
S subdomain Subdomain name for entry to add or modify
T MX, CNAME, A, NS, NONE Record type to add or modify
D record data Record data entry


Here is an example URL for your reference:
https://www.worldwidedns.net/api_dns_modify_dynamic.asp?NAME=your_id& PASSWORD=your_password&DOMAIN=domain.com&S=www&T=A&D=1.2.3.4

SPECIAL NOTE: If you are passing data for a SECONDARY type zone file, you need only place the IP address of the primary server in the S1 field. The S1 field is not listed above but can still be used.

Here is a list of possible return codes that you would receive with the above function. When updating a domain, you can get multiple return codes. Keep this in mind when retrieving our return codes. An example would be a response from each name server advising that the zone was updated or not.

Code Description
211 Name server #1 was updated and accepted your update
212 Name server #2 was updated and accepted your update
213 Name server #3 was updated and accepted your update
401 Login ID you supplied is SUSPENDED, you need to renew your account
403 Login ID and/or Password you supplied is not on file or does not match
405 Domain name supplied is not in your account
407 You have exceeded the 60 entry limit in the zone file. Zone was reloaded anyway
411 Name server #1 gave an error on reload, contact support
412 Name server #2 gave an error on reload, contact support
413 Name server #3 gave an error on reload, contact support