Affordable Bulk DNS Hosting Services

  

World Wide DNS Hosting Services

Sign-up Now!

DNS API PROTOCOL MODIFY

URL to call for DNS updates: https://www.worldwidedns.net/api_dns_modify.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. This 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
SECURE * or IP address(s) Allow or deny zone transfers.
Leave blank will DENY ALL
* will ALLOW ALL
IP Addresses separated by spaces will ALLOW only those IPs
FOLDER folder name Folder name for domain on web based account
HOSTMASTER dotted email address Dotted email address format for responsible person
REFRESH number Number of seconds for REFRESH setting in zone
RETRY number Number of seconds for RETRY setting in zone
EXPIRE number Number of seconds for EXPIRE setting in zone
TTL number Number of seconds for TTL setting in zone
S(1 thru 100) subdomain Subdomain name for entry 1 thru 100
T(1 thru 100) MX, CNAME, A, NS, NONE Record type for entry 1 thru 100
D(1 thru 100) record data Record data for entry 1 thru 100


Here is an example URL for your reference:
https://www.worldwidedns.net/api_dns_modify.asp?NAME=your_id& PASSWORD=your_password&DOMAIN=domain.com&HOSTMASTER=root.domain.com& REFRESH=7200&RETRY=7200&EXPIRE=86400&TTL=60&S1=www&T1=A&D1=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. All the rest of the fields can be ignored unles you want to set the SECURE and FOLDER field.

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
411 Name server #1 kicked an error on reload, contact support
412 Name server #2 kicked an error on reload, contact support
413 Name server #3 kicked an error on reload, contact support