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 deleteDomainRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
(Module Domain > Delete)
(Module Domain > Delete)
 
(4 intermediate revisions not shown)
Line 10: Line 10:
|'''Use'''
|'''Use'''
|Deletes a domain name.
|Deletes a domain name.
-
*In case of '''registered domains''' with status ACT, this will result in a deletion at the registry. Keep in mind that reactivation is not always an option, and if it is, it is sometimes quite expensive.
+
*In case of '''registered domains''' with status ACT, this will result in a deletion at the registry. Keep in mind that not all TLDs support reactivation option and when available this option could be quite expensive.
*Domains with status '''FAI''' can be deleted to get a refund of the paid amount.
*Domains with status '''FAI''' can be deleted to get a refund of the paid amount.
|- style="vertical-align:top;"
|- style="vertical-align:top;"
Line 16: Line 16:
|
|
*'''[[API Format Domain|domain]]'''
*'''[[API Format Domain|domain]]'''
-
*id (''only required if there are two identical domains in your account, for example pre-registrations'')
+
*id (''domain ID, only required if there are two identical domains in your account, for example pre-registrations'')
-
*type (''delete'' (default) or ''pushtoregistry'' (allowed for .de and .at only))
+
*[[API Format type|type]]
|- style="vertical-align:top;"
|- style="vertical-align:top;"
|'''Output'''
|'''Output'''
Line 55: Line 55:
  <openXML>
  <openXML>
   <reply>
   <reply>
-
     < code>0</code>
+
     <nowiki><code>0</code></nowiki>
     <desc></desc>
     <desc></desc>
   </reply>
   </reply>
  </openXML>
  </openXML>

Current revision as of 06:29, 17 June 2016

Contents

Module Domain > Delete

Module domain
Command name deleteDomainRequest
Use Deletes a domain name.
  • In case of registered domains with status ACT, this will result in a deletion at the registry. Keep in mind that not all TLDs support reactivation option and when available this option could be quite expensive.
  • Domains with status FAI can be deleted to get a refund of the paid amount.
Input
  • domain
  • id (domain ID, only required if there are two identical domains in your account, for example pre-registrations)
  • type
Output

-

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('deleteDomainRequest')
  ->setAuth(array('username' => 'username', 'password' => 'password'))
  ->setArgs(array(
    'domain' => array(
      'name' => 'domain-to-delete',
      'extension' => 'nl'
    )
  ));

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>
  <deleteDomainRequest>
    <domain>
      <name>domain-to-delete</name>
      <extension>nl</extension>
    </domain>
  </deleteDomainRequest>
</openXML>
<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    <code>0</code>
    <desc></desc>
  </reply>
</openXML>
Views
Personal tools