DEVELOPER SUPPORT
Nettica provides secure public APIs for managing many of the
services we offer. These APIs are standards-based to accommodate many
different platforms and environments, allowing seamless integration of our
products with your infrastructure.
As part of our growing commitment to providing outstanding features to our
customers, we have developed a Web Service API for managing domains
programmatically. In order to use or test these APIs you must be a
current Nettica Bulk DNS customer.
The API allows you to programmatically:
-
Create Primary Zones
-
Create Secondary Zones
-
Delete Zones
-
List your Domains
-
List all DNS records for a specific domain
-
Add DNS records (A, MX, CNAME)
-
Delete DNS records
-
Update DNS Records
-
Get your current Service Status (credits remaining, total, expiration)
The API is a standard .Net Framework XML Web Service running over HTTPS and
SOAP. The schema for the service may be found here:
https://www.nettica.com/DNS/DnsApi.asmx
The API is firm and will not change except for bug fixes. Please contact Support if you plan to try out this service. We have
a reference implementation available to
use as a guide for implementing your own applications, as well as an API
reference. The source code is available here.
Contact support for complete details.
We make updating the IP address of your host as simple as doing
a simple GET request against a URL. For example:
https://www.nettica.com/Domain/Update.aspx?U=debug&PC=debug&FQDN=example.com&N=1.2.3.4
This makes it extremely easy to update your IP address using
scripts or simple applications. The format of the API is as follows:
URL: https://www.nettica.com/Domain/Update.aspx
HTTP UPDATE API
|
| Parameter |
Description |
| U |
User Name |
| P |
Password, bin.base64 encoded (uuencoded) |
| PC |
Password, clear text (be sure to use SSL) |
| D |
Domain Name |
| A |
Host Name (A record) |
| FQDN |
Fully Qualified Domain Name |
| O |
Old IP address |
| N |
New IP address |
|
|
Notes: If FQDN is specified, A, D, and O are not required.
RETURN CODES
|
| Return Code |
Description |
| 200 |
Record successfully updated |
| 404 |
Bad User Name, Password, or Domain Name |
| 400 |
Error updating record |
|
|
If successful, the HTTP result code is 200. Otherwise, there was an error
updating the record.
DNS CLIENT SOAP API
In addition to the simple HTTP request, Nettica provides a more advanced Web
Services API for retrieving the list of hosts that are available for a given
user. To retrieve this list you submit a well-formed SOAP request to our
service.
The schema for the service is located at:
https://www.nettica.com/DNS/DnsManager.asmx
The follow example demonstrates how to call the API from C# using the Microsoft
.Net Framework.
com.nettica.www.DnsManager dns = new
com.nettica.www.DnsManager();
com.nettica.www.ListResult result = dns.List( UserName, Password );
// Password must be bin.base64 encoded
for (int i=0; i<result.NumEntries; i++)
{
com.nettica.www.DnsEntry entry = result.Entries[i];
Console.WriteLine( entry.HostName + " " +
entry.DomainName + " = " + entry.Data );
}
dns.Dispose();
MORE INFORMATION
Before starting development, please contact Support
for additional information and guidelines on implementing commercial products using
our APIs. There are test accounts and domains available to verifying your
client before release.
Use of all our APIs are monitored.
|