WAPI – command domain-create

  Domains, WAPI (API interface)

To create a domain via WAPI use the command domain-create. The command is synchronous, ie. domain registration is performed on-line. However please note that the domain registration process can take 5-20 seconds, depending on the workload of our system and the target domain registries.

CAUTION! For CZ and EU domains is required the approval of the owner with the  EURid or CZ.NIC rules when registering a domain. Our terms and conditions requires to familiar your customer with our terms and terms of particular domain register! If you do not do so then in case of conflict with domain it may cause loss of domain without compensation.

For this command is applied limit max. 100 requests per hour. More in article Wapi limits

Parameters

  • name – domain name – required
  • period – number of years – required
  • nsset – NSSET for CZ domains – required (dns or nsset)
  • dns – DNS setting – required (dns or nsset)
    1. empty – use default settings(DNS servers WEDOS). Attention, dns element is required it is empty only!
    2. list of NS servers – can not be used for .cz domains (each entry must contain the field name, optionally addr_ip4 and addr_ip6, individual servers are embedded within the element server )
  • owner_c – owner´s contact- required
  • admin_c – admin contact – not required
  • rules – first and last name of a person, who accept terms and conditions with our and registry rules (usual domain owner)

You must specify nsset or dns.

Return values

  • 1000 – domain has been successfully registered
  • 1001 – registration request was accepted (some domains can not be registered immediately you will be informed about the progress via notification system, more in the article WAPI – notification)
  • 3002 – insufficient credit on credit account
  • 3201 – domain name is already used
  • 3204 – domain is quarantined
  • 3205 – domain is reserved
  • 3206 – domain name is blocked
  • 2201 – unsupported TLD
  • 2203 – invalid period
  • 3221 – creation failed
  • 4207 – creation failed – connection error

Return data

After successful registration, returned two items in the data node:

  • num – order number
  • expiration – expiration date
  • credit -information about the balance on the credit account after the operation
    • amount – remaining amount
    • currency – currency

Example 1: Creating of domain with DNS settings WEDOS

XML request:

<request>
 <user>tester</user>
 <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth>
 <command>domain-create</command>
 <clTRID>a44B</clTRID>
 <data>
  <name>example.cz</name>
  <period>1</period>
  <dns></dns>
  <owner_c>_ID_KONTAKTU_MAJITELE_</owner_c>
  <admin_c>_ID_KONTAKTU_ADMINA_</admin_c>
  <rules>
   <fname>Jan</fname>
   <lname>Novák</lname>
  </rules>
 </data>
</request>

XML response:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1286356644</timestamp>
 <clTRID>a44B</clTRID>
 <svTRID>1286356644.0246.21616</svTRID>
 <command>domain-create</command>
 <data>
  <num>1311000863</num>
  <expiration>2011-10-06</expiration>
 </data>
</response>

Example 2: Registration of domain with using your own NSSET

XML request:

<request>
 <user>tester</user>
 <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth>
 <command>domain-create</command>
 <clTRID>a44B</clTRID>
 <data>
  <name>example.cz</name>
  <period>3</period>
  <nsset>TESTNSSET</nsset>
  <owner_c>_ID_KONTAKTU_MAJITELE_</owner_c>
  <admin_c>_ID_KONTAKTU_ADMINA_</admin_c>
  <rules>
   <fname>Jan</fname>
   <lname>Novák</lname>
  </rules>
 </data>
</request>

XML response:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1286356644</timestamp>
 <clTRID>a44B</clTRID>
 <svTRID>1286356644.0246.21616</svTRID>
 <command>domain-create</command>
 <data>
  <num>1311000863</num>
  <expiration>2011-10-06</expiration>
 </data>
</response>

Example 3: Registration of domain with using of  DNS servers list

XML request:

<request>
 <user>tester</user>
 <auth>202b62bc4646281f97d225db1249840c8452dd8f</auth>
 <command>domain-create</command>
 <clTRID>a44B</clTRID>
 <data>
  <name>example.eu</name>
  <period>1</period>
  <dns>
   <server>
    <name>ns.wedos.net</name>
   </server> 
   <server> 
    <name>ns.wedos.cz</name> 
   </server> 
  </dns> 
  <owner_c>c1049663X</owner_c> 
  <rules>
   <fname>Jan</fname>
   <lname>Novák</lname>
  </rules>
 </data> 
</request>

XML response:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1286356644</timestamp>
 <clTRID>a44B</clTRID>
 <svTRID>1286356644.0246.21616</svTRID>
 <command>domain-create</command>
 <data>
  <num>1311000863</num>
  <expiration>2011-10-06</expiration>
 </data>
</response>