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 100 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 |
|
