API Module Extension searchExtensionRequest

From Openprovider API documentation

(Difference between revisions)

Revision as of 10:19, 1 June 2020

Module Extension > Search

Module	extension
Command name	searchExtensionRequest
Use	Returns a list of extensions (TLDs) matching search criteria
Input	limit offset (default value: 0) onlyNames (use to receive only the list of TLDs in the response) withDescription (default value: 0) withPrice (default value: 0) withUsageCount (default value: 0) extensions (provide an array of extensions to search for specific TLDs)
Output	Result set of extension details: name minPeriod (minimum period of registration in years) maxPeriod (maximum period of registration in years) domicilePrice (if domicile service available for this TLD) createPrice (displays current base price vs reseller's Tier price for domain creation, without any other discounts) resellerPrice (displays current domain creation price with discounts applicable to reseller (i.e. membership plan or personal promo)) renewPrice (displays current domain renewal price with discounts applicable to reseller) transferPrice (displays current domain transfer price with discounts applicable to reseller) restorePrice (displays current domain restore price with discounts applicable to reseller) softRestorePrice (displays current domain restore from soft quarantine price with discounts applicable to reseller) updatePrice (displays current domain update price with discounts applicable to reseller) transferAvailable (if transfer is available for this TLD) tradeAvailable (if trade is available for this TLD) isTransferAuthCodeRequired (if transfer is done via authorization code) isTradeAuthCodeRequired (if trade is done via authorization code) isAuthCodeRequested (if authorization code could be requested from registry via e-mail) isAuthCodeAvailable (if authorization code is available immediately on demand) isAuthCodeChangeable (if authorization code could be changed via API call) domicileAvailable (if domicile \ trustee service could be used for TLD) quarantinePeriod (period in days that allows to restore domain after deletion) dnssecAllowed (if DNSSEC is allowed for this TLD) status (ACT - active, PRE - only pre-registrations available) supportedIdnScripts (the list of supported IDN scripts) prices usageCount (to show number of domains with such TLD in the account) description isPrivateWhoisAllowed (if Whois Privacy Protection could be enabled on domains registered in this TLD)

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('searchExtensionRequest')
  ->setAuth(array('username' => 'username', 'password' => 'password'))
  ->setArgs(array(
    'withUsageCount' => true
  ));

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>
  <searchExtensionRequest>
    <withUsageCount>1</withUsageCount>
    <limit>3</limit>
  </searchExtensionRequest>
</openXML>

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    <code>0</code>
    <desc></desc>
    <data>
      <results>
        <array>
          <item>
            <name>ac</name>
            <transferAvailable>0</transferAvailable>
            <isRransferAuthCodeRequired>0</isTransferAuthCodeRequired>
            <domicileAvailable>0</domicileAvailable>
          </item>
          <item>
            <name>ae</name>
            <transferAvailable>1</transferAvailable>
            <isTransferAuthCodeRequired>1</isTransferAuthCodeRequired>
            <domicileAvailable>0</domicileAvailable>
          </item>
          <item>
            <name>ag</name>
            <transferAvailable>0</transferAvailable>
            <isTransferAuthCodeRequired>1</isTransferAuthCodeRequired>
            <domicileAvailable>0</domicileAvailable>
          </item>
        </array>
      </results>
      <total>117</total>
    </data>
  </reply>
</openXML>

@@ Line 19: / Line 19: @@
 *withPrice (''default value: 0'')
 *withUsageCount (''default value: 0'')
+*extensions (provide an array of extensions to search for specific TLDs)
 |- style="vertical-align:top;"
 |'''Output'''