AtomiaDNS.net Quick Guide

Useful information:

Sign-up form: http://atomiadns.com/demo
Web App URL: http://atomiadns.net
Atomia DNS API URL: http://api.atomiadns.net/
Nameservers to use: ns1.atomiadns.net, ns2.atomiadns.net
User name (X-Auth-Username): Email address used to sign up
Password (X-Auth-Password): Sent to your e-mail during sign-up

Before you start

In order to manage your DNS setting for a domain name with AtomiaDNS.net you will need to log in to your domain registration control panel and set the nameservers to ns1.atomiadns.net and ns2.atomiadns.net.

Keep in mind that even if AtomiaDNS.net provides a fully functional DNS service, there are no guarantees in terms of up-time or availability.

API Examples using CURL

The following examples are all prepared to work against the AtomiaDNS.net free DNS service, just replace [email protected] and pa$$word with your credentials and you’re ready to go.

Check out the API documentation for all available methods.

Add new zone

curl -i -X POST -d '[ "my-domain.com", 3600, "ns1.atomiadns.net.", "user.name.com.", 3600, 3600, 3600, 3600, [ "ns1.atomiadns.net.", "ns2.atomiadns.net." ], "atomiadns" ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word' 'http://api.atomiadns.net/pretty/atomiadns.json/AddZone';

Notes:

my-domian.com Replace with domain name to add
user.name.com Replace with your e-mail address, use a dot (.) instead of an at (@)
atomiadns Nameserver group, leave as is

Get zone

curl -i -X POST -d '[ "my-domain.com" ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word' 'http://api.atomiadns.net/pretty/atomiadns.json/GetZone'

Delete zone

curl -i -X POST -d '[ "my-domain.com" ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word' 'http://api.atomiadns.net/pretty/atomiadns.json/DeleteZone'

Update IP address for an A record

In order to update a zone record you will need to provide the id of the record. This parameter can easily be found by using the Get zone method.

Example of json returned when using Get zone method:

"records" : [
         {
            "ttl" : "3600",
            "label" : "@",
            "class" : "IN",
            "id" : "9",
            "type" : "A",
            "rdata" : "127.0.0.1"
         },
...
Command for updating a record:
curl -i -X POST -d '[ "my-domain.com", [ { "ttl" : "3600", "label" : "@", "class" : "IN", "id" : "9", "type" : "A", "rdata" : "192.168.0.1" } ] ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word'  'http://api.atomiadns.net/pretty/atomiadns.json/EditDnsRecords'

Add a new record

curl -i -X POST -d '[ "my-domain.com", [ { "ttl" : "3600", "label" : "subdomain", "class" : "IN", "type" : "A", "rdata" : "192.168.1.10" } ] ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word'  'http://api.atomiadns.net/pretty/atomiadns.json/SetDnsRecords'

Change user password

curl -i -X POST -d '[ "[email protected]", "new_pa$$word" ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word' 'http://api.atomiadns.net/pretty/atomiadns.json/EditAccount'

Terminate account

curl -i -X POST -d '[ "[email protected]" ]' -H 'X-Auth-Username: [email protected]' -H 'X-Auth-Password: pa$$word' 'http://api.atomiadns.net/pretty/atomiadns.json/DeleteAccount'