API Module Extension searchExtensionRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
Line 25: Line 25:
*minPeriod (minimum period of registration in years)
*minPeriod (minimum period of registration in years)
*maxPeriod (maximum 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)
*transferAvailable (if transfer is available for this TLD)
*tradeAvailable (if trade is available for this TLD)
*tradeAvailable (if trade is available for this TLD)

Revision as of 04:25, 15 April 2019

Contents

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)
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
  • isLockingAllowed (if TLD supports 'theft protection')
  • 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>
Retrieved from "https://doc.openprovider.eu/API_Module_Extension_searchExtensionRequest"
Views
Personal tools