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 checkDomainRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
(Module Domain > Check)
m
Line 21: Line 21:
*status - free or active (indicating whether the domain is available for registration or not)
*status - free or active (indicating whether the domain is available for registration or not)
*reason (if status is ''active'')
*reason (if status is ''active'')
 +
*premium price - price for Create operation
|}
|}
Line 69: Line 70:
  </openXML>
  </openXML>
-
<?xml version="1.0" encoding="UTF-8"?>
+
<pre>
-
<openXML>
+
<openXML>
-
  <reply>
+
<reply>
-
    < code>0</code>
+
<code>0</code>
-
    <desc>
+
<desc/>
-
    </desc>
+
<data>
-
    <data>
+
<array>
-
      <array>
+
<item>
-
        <item>
+
<domain>openprovider.nl</domain>
-
          <domain>openprovider.nl</domain>
+
<status>active</status>
-
          <status>active</status>
+
<reason>Domain exists</reason>
-
          <reason>Domain exists</reason>
+
</item>
-
        </item>
+
<item>
-
        <item>
+
<domain>this-domain-is-free.biz</domain>
-
          <domain>this-domain-is-free.biz</domain>
+
<status>free</status>
-
          <status>free</status>
+
<premium>
-
        </item>
+
<price>
-
        <item>
+
<create>75</create>
-
          <domain>greece.guru</domain>
+
</price>
-
          <status>active</status>
+
</premium>
-
          <reason>Reserved Domain Name</reason>
+
</item>
-
        </item>
+
<item>
-
      </array>
+
<domain>greece.guru</domain>
-
    </data>
+
<status>active</status>
-
  </reply>
+
<reason>Reserved Domain Name</reason>
-
</openXML>
+
</item>
 +
</array>
 +
</data>
 +
</reply>
 +
</openXML>
 +
</pre>

Revision as of 04:31, 13 May 2020

Contents

Module Domain > Check

Module domain
Command name checkDomainRequest
Use Returns the availability of one or more domain names (max 15 per request)
Input
Output Result set of domain availabilities:
  • domain
  • status - free or active (indicating whether the domain is available for registration or not)
  • reason (if status is active)
  • premium price - price for Create operation

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('checkDomainRequest')
  ->setAuth(array('username' => 'username', 'password' => 'password'))
  ->setArgs(array(
    'domains' => array(
      array(
        'name' => 'openprovider',
        'extension' => 'com'
      ),
      array(
        'name' => 'this-domain-is-free',
        'extension' => 'biz'
      )
    )
  ));

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>
  <checkDomainRequest>
    <domains>
      <array>
        <item>
          <name>openprovider</name>
          <extension>com</extension>
        </item>
        <item>
          <name>this-domain-is-free</name>
          <extension>biz</extension>
        </item>
        <item>
          <name>greece</name>
          <extension>guru</extension>
        </item>
      </array>
    </domains>
  </checkDomainRequest>
</openXML>
<openXML>
<reply>
<code>0</code>
<desc/>
<data>
	<array>
		<item>
			<domain>openprovider.nl</domain>
			<status>active</status>
			<reason>Domain exists</reason>
		</item>
		<item>
			<domain>this-domain-is-free.biz</domain>
			<status>free</status>
			<premium>
				<price>
					<create>75</create>
				</price>
			</premium>
		</item>
		<item>
			<domain>greece.guru</domain>
			<status>active</status>
			<reason>Reserved Domain Name</reason>
		</item>
	</array>
</data>
</reply>
</openXML>
Views
Personal tools