This documentation has moved

XML API documentation can now be found at developer.openprovider.com. This page will remain available until September 2026, but will no longer be updated.

The XML API itself is not changing. Your existing integration continues to work.

API Module Domain createDomainRequest

From Openprovider API documentation

Revision as of 10:55, 8 June 2016 by WikiSysop (Talk | contribs)
Jump to: navigation, search

Contents

Module Domain > Create

Module domain
Command name createDomainRequest
Use Registers a domain with the provided data
Input
  • domain
  • period (registration period 1-10 years depending on what specific TLD supports)
  • ownerHandle (customer unique identifier or handle, can be created via createCustomerRequest API method)
  • adminHandle (customer unique identifier or handle, can be created via createCustomerRequest API method)
  • techHandle (customer unique identifier or handle, can be created via createCustomerRequest API method)
  • billingHandle (customer unique identifier or handle, can be created via createCustomerRequest API method)
  • resellerHandle (customer unique identifier or handle, can be created via createCustomerRequest API method)
  • nsGroup ('nameserver group', mandatory field if nameServers field is empty)
  • nsTemplateName (name of the template to use to automatically create DNS zone on the domain)
  • nameServers (mandatory field if nsGroup field is empty)
  • isDnssecEnabled (0 (default) or 1 - Only accepted when nameservers of Openprovider are used)
  • useDomicile (0 (default) or 1, enables use of domicile or trustee address for TLD that require local presence)
  • isPrivateWhoisEnabled (0 (default) or 1, enables whois privacy on domain)
  • promoCode
  • autorenew (default (default), on or off)
  • comments
  • dnssecKeys
  • additionalData (mandatory for some TLDs)
  • applicationMode (required for new gTLDs; allowed values:
    • sunrise (during the Sunrise of a new gTLD launch only; special fees may apply; it's required to submit an SMD file in the applicationSmd parameter)
    • landrush (during the Landrush of a new gTLD launch only; special fees may apply)
    • preregistration (during the period in which Openprovider accepts pre-registrations for the TLD)
    • claims (during the Trademark Claims period for the TLD; details can be found on the TLD details pages via the overview page)
Output
  • status (ACT - active or REQ - requested)
  • authCode (EPP code that is required for domain transfer, only in case if TLD supports it)
  • activationDate (only in case of a succeeded realtime domain registration)
  • expirationDate (registry expiration date, available only in case of a succeeded realtime domain registration)
  • expirationDateOpenprovider (date till which domain has to be renewed by reseller in Openprovider, available only in case of a succeeded realtime domain registration)

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('createDomainRequest')
  ->setAuth(array('username' => 'username', 'password' => 'password'))
  ->setArgs(array(
    'ownerHandle' => 'SR003891-NL',
    'adminHandle' => 'SR003891-NL',
    'techHandle' => 'SR003891-NL',
    'billingHandle' => 'SR003891-NL',
    'domain' => array(
      'name' => 'this-domain-is-registered',
      'extension' => 'com'
    ),
    'period' => '1',
    'nsGroup' => 'dns-openprovider',
    'nsTemplateName' => 'Shared hosting server Apollo',
  ));

Raw XML

Please note that newlines and leading spaces are added only for readability. Those whitespaces should be excluded from your XML command before sending it to Openprovider.

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <password>password</password>
  </credentials>
  <createDomainRequest>
    <ownerHandle>SR003891-NL</ownerHandle>
    <adminHandle>SR003891-NL</adminHandle>
    <techHandle>SR003891-NL</techHandle>
    <billingHandle>SR003891-NL</billingHandle>
    <domain>
      <name>this-domain-is-registered</name>
      <extension>com</extension>
    </domain>
    <period>1</period>
    <nsGroup>dns-openprovider</nsGroup>
    <nsTemplateName>Shared hosting server Apollo</nsTemplateName>
  </createDomainRequest>
</openXML>
<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    < code>0</code>
    <desc></desc>
    <data>
      <status>ACT</status>
      <activationDate>2011-04-22 14:14:32</activationDate>
      <expirationDate>2012-04-22 14:41:32</expirationDate>
      <expirationDateOpenprovider>2012-04-22 14:41:32</expirationDateOpenprovider>
      <authCode>123456</authCode>
    </data>
  </reply>
</openXML>
Views
Personal tools