Simple DNS Plus
menubar Skip Navigation Links
Home
Product Details
Download
Purchase
Support
Company
Search
menubar

Knowledge Base
Article ID:
1207
Last updated:
15 Jan 2008
Print Print
E-mail E-Mail
Comment Comment
New in Simple DNS Plus v. 5.0 - HTTP API

In Simple DNS Plus v. 5.0 the HTTP API has been extended with new commands and parameters to enable more powerful and easier integration with your solutions through simple scripting or programming.

addrecord, updaterecord, removerecord

These 3 new commands make it possible to add/update/remove individual DNS records of any type without having to parse and re-assemble an entire zone file.
The zone's SOA-record serial number is automatically incremented, secondary DNS servers notified, etc.

For single record updates, using these new commands is more efficient than "updatezone" because it allows secondary DNS servers to retrieve the change through an incremental zone transfer instead of a full zone transfer.

The 3 commands all take the same parameters:
zone = the name of the zone to update
name = the name of the DNS record to update in zone file format (@ = zone name, etc.)
type = the DNS record type (for example 'A' or 'MX')
data = the record data in zone file format (optional for removerecord)
ttl = the Time-To-Live value in seconds (optional) 

For example:
Add a new MX-record:
http://127.0.0.1:8053/addrecord?zone=examle.com&name=@&type=MX&data=10+mail
Update a CNAME-record:
http://127.0.0.1:8053/updaterecord?zone=example.com&name=www&type=CNAME&data=@&ttl=300
Remove all TXT-records for zone name:
http://127.0.0.1:8053/removerecord?zone=example.com&name=@&type=TXT

As with all other HTTP API commands, these parameters can either be sent as part of the URL as above (GET), or as form data in the body of a POST request.

updatehost + IPv6 address

The "updatehost" command now also works with IPv6 addresses.

For example, the following adds or updates an AAAA-record:
http://127.0.0.1:8053/updatehost?host=host.domain.com&data=1234::4321

zonelist?listtype=xml

It is now possible to retrieve a list of local zones in XML format.
The previous formats (simple, primary, secondary, extended) are also still available.

Image1.png

status?format=xml

The status page is now also available as XML (previously only plain text format).
This make it possble to retrieve status information in a structured format from Simple DNS Plus, for use on web-pages and other applications etc.
The XML includes DNS request counts for the last 60 seconds, which for example could be used to render a graph (see HTML version below).

Image2.png

status?format=html

And the status page is now also available as HTML including a simple HTML graph of DNS request counts for the last 60 seconds:

Image3.png

 

Please note that Simple DNS Plus v. 5.0 also supports the "higher level" Simple DNS Plus API for .NET and COM which makes it even easier to program against DNS data in Simple DNS Plus.

REFERENCE:
For more information, please see the following knowledge base article:

KB Article New in Simple DNS Plus v. 5.0




Comments: RSS

18 Jan 2008 20:48 GMT - by Duane Shippy:
Has the SDNS API been updated since last March? We were wanting a feature where we could create new zones as a alias of an existing zone (using the zone file sharing) via the API.

18 Jan 2008 22:08 GMT - by Jesper - JH Software:
Thanks for your feedback Duane.
Yes, the HTTP API has been updated with all the new features listed above.
I am sorry that your suggestion didn't make it into this release, but we do still have it on the list for future versions.
Thanks for the reminder.

13 May 2008 15:04 GMT - by Jesper - JH Software:
The option to create a new zone as an alias of an existing zone via the HTTP API has now been implemented in v. 5.1.
See http://www.simpledns.com/kb.aspx?kbid=1246



Copyright © 1999-2008 JH Software ApS. All Rights Reserved.
E-mail questions to
Site Map | Terms of Use | Privacy Statement | Return Policy | Contact Us
product and website by JH Software
help index