WAPI – command dns-domain-add

  WAPI (API interface), WDNS

Adds a new domain to the DNS

Parameters

  • name – domain name – required
  • type – domain record type (primary/secondary) – optional (default: primary)
  • axfr_enabled – allowed outgoing AXFR? (0/1) – only primary domain – optional (default: 0)
  • axfr_ip -list of allowed IP addresses for AXFR (only for primary record, required if axfr_enabled = 1)
    • ip – ip address for outgoing AXFR
  • primary_ip – IP address of the DNS server with the primary domain record – required for secondary record

Return Values

  • 1000 = ok
  • 2100 = missing required parameter
  • 2101 = invalid input parameters
  • 2201 = unsupported TLD
  • 2202 = invalid domain name
  • 2301 = wrong format of type 
  • 2302 = missing parameter primary_ip
  • 2303 = wrong format of primary_ip
  • 2304 = invalid format axfr_enabled
  • 2305 = missing required parameter axfr_ips
  • 2306 = invalid format of axfr_ips
  • 2308 = invalid format of ns
  • 2322 = reached limit of domains in the DNS per user
  • 3302 = add domain to DNS failed
  • 3303 = domain already exists in DNS

Return data

Command does not return any data.

Expample of use

XML query:

<request>
 <user>tester</user>
 <auth>fb82be1466331148816bdbac855a6b1bd4e24b81</auth>
 <command>dns-domain-add</command>
 <clTRID>5346</clTRID>
 <data>
  <name>example.cz</name>
  <axfr_enabled>1</axfr_enabled>
  <axfr_ips>
   <ip>1.2.3.4</ip>
  </axfr_ips>
 </data>
</request>

XML response:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1288166851</timestamp>
 <clTRID>5346</clTRID>
 <svTRID>1288166851.4416.23467.1</svTRID>
 <command>dns-domain-add</command>
</response>