API Module Extension searchExtensionRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
 
Line 58: Line 58:
   ->setAuth(array('username' => 'username', 'password' => 'password'))
   ->setAuth(array('username' => 'username', 'password' => 'password'))
   ->setArgs(array(
   ->setArgs(array(
-
     'withUsageCount' => true
+
     'extensions' => array("ac","ae","ag")
   ));
   ));
Line 66: Line 66:
  <openXML>
  <openXML>
   <credentials>
   <credentials>
-
    <username>username</username>
+
      <username>***</username>
-
    <password>password</password>
+
      <password>***</password>
   </credentials>
   </credentials>
   <searchExtensionRequest>
   <searchExtensionRequest>
-
    <withUsageCount>1</withUsageCount>
+
      <extensions>
-
    <limit>3</limit>
+
        <array>
 +
            <item>ac</item>
 +
            <item>ae</item>
 +
            <item>ag</item>
 +
        </array>
 +
      </extensions>
 +
      <withPrice>0</withPrice>
   </searchExtensionRequest>
   </searchExtensionRequest>
  </openXML>
  </openXML>
 +
 +
===Response===
  <?xml version="1.0" encoding="UTF-8"?>
  <?xml version="1.0" encoding="UTF-8"?>
  <openXML>
  <openXML>
   <reply>
   <reply>
-
    <nowiki><code>0</code></nowiki>
+
      <code>0</code>
-
    <desc></desc>
+
      <desc></desc>
-
    <data>
+
      <data>
-
      <results>
+
        <results>
-
        <array>
+
            <array>
-
          <item>
+
              <item>
-
            <name>ac</name>
+
                  <name>ac</name>
-
            <transferAvailable>0</transferAvailable>
+
                  <minPeriod>1</minPeriod>
-
            <isRransferAuthCodeRequired>0</isTransferAuthCodeRequired>
+
                  <maxPeriod>10</maxPeriod>
-
            <domicileAvailable>0</domicileAvailable>
+
                  <transferAvailable>1</transferAvailable>
-
          </item>
+
                  <tradeAvailable>0</tradeAvailable>
-
          <item>
+
                  <renewAvailable>1</renewAvailable>
-
            <name>ae</name>
+
                  <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
-
            <transferAvailable>1</transferAvailable>
+
                  <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
-
            <isTransferAuthCodeRequired>1</isTransferAuthCodeRequired>
+
                  <isAuthCodeRequested>0</isAuthCodeRequested>
-
            <domicileAvailable>0</domicileAvailable>
+
                  <isAuthCodeAvailable>1</isAuthCodeAvailable>
-
          </item>
+
                  <isAuthCodeChangeable>1</isAuthCodeChangeable>
-
          <item>
+
                  <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
-
            <name>ag</name>
+
                  <domicileAvailable>0</domicileAvailable>
-
            <transferAvailable>0</transferAvailable>
+
                  <softQuarantinePeriod>0</softQuarantinePeriod>
-
            <isTransferAuthCodeRequired>1</isTransferAuthCodeRequired>
+
                  <quarantinePeriod>0</quarantinePeriod>
-
            <domicileAvailable>0</domicileAvailable>
+
                  <dnssecAllowed>1</dnssecAllowed>
-
          </item>
+
                  <status>ACT</status>
-
        </array>
+
                  <supportedApplicationMode/>
-
      </results>
+
                  <billingHandleEnabled>0</billingHandleEnabled>
-
      <total>117</total>
+
                  <resellerHandleEnabled>0</resellerHandleEnabled>
-
    </data>
+
                  <supportedIdnScripts/>
 +
                  <ownerHandleSupported>1</ownerHandleSupported>
 +
                  <adminHandleSupported>1</adminHandleSupported>
 +
                  <techHandleSupported>1</techHandleSupported>
 +
                  <billingHandleSupported></billingHandleSupported>
 +
                  <resellerHandleSupported></resellerHandleSupported>
 +
                  <dnssecKeysAllowed>1</dnssecKeysAllowed>
 +
                  <dnssecDigestsAllowed>1</dnssecDigestsAllowed>
 +
                  <dnssecMaxRecordsAmount>0</dnssecMaxRecordsAmount>
 +
                  <dnssecAlgorithms>
 +
                    <array>
 +
                        <item>8</item>
 +
                    </array>
 +
                  </dnssecAlgorithms>
 +
              </item>
 +
              <item>
 +
                  <name>ae</name>
 +
                  <minPeriod>1</minPeriod>
 +
                  <maxPeriod>5</maxPeriod>
 +
                  <transferAvailable>1</transferAvailable>
 +
                  <tradeAvailable>0</tradeAvailable>
 +
                  <renewAvailable>1</renewAvailable>
 +
                  <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
 +
                  <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
 +
                  <isAuthCodeRequested>1</isAuthCodeRequested>
 +
                  <isAuthCodeAvailable>0</isAuthCodeAvailable>
 +
                  <isAuthCodeChangeable>1</isAuthCodeChangeable>
 +
                  <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
 +
                  <domicileAvailable>0</domicileAvailable>
 +
                  <softQuarantinePeriod>30</softQuarantinePeriod>
 +
                  <quarantinePeriod>0</quarantinePeriod>
 +
                  <dnssecAllowed>0</dnssecAllowed>
 +
                  <status>ACT</status>
 +
                  <supportedApplicationMode/>
 +
                  <billingHandleEnabled>0</billingHandleEnabled>
 +
                  <resellerHandleEnabled>0</resellerHandleEnabled>
 +
                  <supportedIdnScripts/>
 +
                  <ownerHandleSupported>1</ownerHandleSupported>
 +
                  <adminHandleSupported>1</adminHandleSupported>
 +
                  <techHandleSupported>1</techHandleSupported>
 +
                  <billingHandleSupported></billingHandleSupported>
 +
                  <resellerHandleSupported></resellerHandleSupported>
 +
              </item>
 +
              <item>
 +
                  <name>ag</name>
 +
                  <minPeriod>1</minPeriod>
 +
                  <maxPeriod>10</maxPeriod>
 +
                  <transferAvailable>1</transferAvailable>
 +
                  <tradeAvailable>0</tradeAvailable>
 +
                  <renewAvailable>1</renewAvailable>
 +
                  <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
 +
                  <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
 +
                  <isAuthCodeRequested>0</isAuthCodeRequested>
 +
                  <isAuthCodeAvailable>1</isAuthCodeAvailable>
 +
                  <isAuthCodeChangeable>1</isAuthCodeChangeable>
 +
                  <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
 +
                  <domicileAvailable>0</domicileAvailable>
 +
                  <softQuarantinePeriod>44</softQuarantinePeriod>
 +
                  <quarantinePeriod>28</quarantinePeriod>
 +
                  <dnssecAllowed>1</dnssecAllowed>
 +
                  <status>ACT</status>
 +
                  <supportedApplicationMode/>
 +
                  <billingHandleEnabled>1</billingHandleEnabled>
 +
                  <resellerHandleEnabled>0</resellerHandleEnabled>
 +
                  <supportedIdnScripts/>
 +
                  <ownerHandleSupported>1</ownerHandleSupported>
 +
                  <adminHandleSupported>1</adminHandleSupported>
 +
                  <techHandleSupported>1</techHandleSupported>
 +
                  <billingHandleSupported>1</billingHandleSupported>
 +
                  <resellerHandleSupported></resellerHandleSupported>
 +
                  <dnssecKeysAllowed>1</dnssecKeysAllowed>
 +
                  <dnssecDigestsAllowed>1</dnssecDigestsAllowed>
 +
                  <dnssecMaxRecordsAmount>0</dnssecMaxRecordsAmount>
 +
                  <dnssecAlgorithms>
 +
                    <array>
 +
                        <item>6</item>
 +
                        <item>8</item>
 +
                        <item>10</item>
 +
                        <item>12</item>
 +
                        <item>13</item>
 +
                        <item>14</item>
 +
                    </array>
 +
                  </dnssecAlgorithms>
 +
              </item>
 +
            </array>
 +
        </results>
 +
        <total>3</total>
 +
      </data>
   </reply>
   </reply>
  </openXML>
  </openXML>

Current revision as of 10:39, 1 June 2020

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)
  • 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(
    'extensions' => array("ac","ae","ag")
  ));

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>
     <password>***</password>
  </credentials>
  <searchExtensionRequest>
     <extensions>
        <array>
           <item>ac</item>
           <item>ae</item>
           <item>ag</item>
        </array>
     </extensions>
     <withPrice>0</withPrice>
  </searchExtensionRequest>
</openXML>


Response

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
     0
     <desc></desc>
     <data>
        <results>
           <array>
              <item>
                 <name>ac</name>
                 <minPeriod>1</minPeriod>
                 <maxPeriod>10</maxPeriod>
                 <transferAvailable>1</transferAvailable>
                 <tradeAvailable>0</tradeAvailable>
                 <renewAvailable>1</renewAvailable>
                 <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
                 <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
                 <isAuthCodeRequested>0</isAuthCodeRequested>
                 <isAuthCodeAvailable>1</isAuthCodeAvailable>
                 <isAuthCodeChangeable>1</isAuthCodeChangeable>
                 <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
                 <domicileAvailable>0</domicileAvailable>
                 <softQuarantinePeriod>0</softQuarantinePeriod>
                 <quarantinePeriod>0</quarantinePeriod>
                 <dnssecAllowed>1</dnssecAllowed>
                 <status>ACT</status>
                 <supportedApplicationMode/>
                 <billingHandleEnabled>0</billingHandleEnabled>
                 <resellerHandleEnabled>0</resellerHandleEnabled>
                 <supportedIdnScripts/>
                 <ownerHandleSupported>1</ownerHandleSupported>
                 <adminHandleSupported>1</adminHandleSupported>
                 <techHandleSupported>1</techHandleSupported>
                 <billingHandleSupported></billingHandleSupported>
                 <resellerHandleSupported></resellerHandleSupported>
                 <dnssecKeysAllowed>1</dnssecKeysAllowed>
                 <dnssecDigestsAllowed>1</dnssecDigestsAllowed>
                 <dnssecMaxRecordsAmount>0</dnssecMaxRecordsAmount>
                 <dnssecAlgorithms>
                    <array>
                       <item>8</item>
                    </array>
                 </dnssecAlgorithms>
              </item>
              <item>
                 <name>ae</name>
                 <minPeriod>1</minPeriod>
                 <maxPeriod>5</maxPeriod>
                 <transferAvailable>1</transferAvailable>
                 <tradeAvailable>0</tradeAvailable>
                 <renewAvailable>1</renewAvailable>
                 <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
                 <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
                 <isAuthCodeRequested>1</isAuthCodeRequested>
                 <isAuthCodeAvailable>0</isAuthCodeAvailable>
                 <isAuthCodeChangeable>1</isAuthCodeChangeable>
                 <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
                 <domicileAvailable>0</domicileAvailable>
                 <softQuarantinePeriod>30</softQuarantinePeriod>
                 <quarantinePeriod>0</quarantinePeriod>
                 <dnssecAllowed>0</dnssecAllowed>
                 <status>ACT</status>
                 <supportedApplicationMode/>
                 <billingHandleEnabled>0</billingHandleEnabled>
                 <resellerHandleEnabled>0</resellerHandleEnabled>
                 <supportedIdnScripts/>
                 <ownerHandleSupported>1</ownerHandleSupported>
                 <adminHandleSupported>1</adminHandleSupported>
                 <techHandleSupported>1</techHandleSupported>
                 <billingHandleSupported></billingHandleSupported>
                 <resellerHandleSupported></resellerHandleSupported>
              </item>
              <item>
                 <name>ag</name>
                 <minPeriod>1</minPeriod>
                 <maxPeriod>10</maxPeriod>
                 <transferAvailable>1</transferAvailable>
                 <tradeAvailable>0</tradeAvailable>
                 <renewAvailable>1</renewAvailable>
                 <isTransferAuthCodeRequired>yes</isTransferAuthCodeRequired>
                 <isTradeAuthCodeRequired>no</isTradeAuthCodeRequired>
                 <isAuthCodeRequested>0</isAuthCodeRequested>
                 <isAuthCodeAvailable>1</isAuthCodeAvailable>
                 <isAuthCodeChangeable>1</isAuthCodeChangeable>
                 <isPrivateWhoisAllowed>0</isPrivateWhoisAllowed>
                 <domicileAvailable>0</domicileAvailable>
                 <softQuarantinePeriod>44</softQuarantinePeriod>
                 <quarantinePeriod>28</quarantinePeriod>
                 <dnssecAllowed>1</dnssecAllowed>
                 <status>ACT</status>
                 <supportedApplicationMode/>
                 <billingHandleEnabled>1</billingHandleEnabled>
                 <resellerHandleEnabled>0</resellerHandleEnabled>
                 <supportedIdnScripts/>
                 <ownerHandleSupported>1</ownerHandleSupported>
                 <adminHandleSupported>1</adminHandleSupported>
                 <techHandleSupported>1</techHandleSupported>
                 <billingHandleSupported>1</billingHandleSupported>
                 <resellerHandleSupported></resellerHandleSupported>
                 <dnssecKeysAllowed>1</dnssecKeysAllowed>
                 <dnssecDigestsAllowed>1</dnssecDigestsAllowed>
                 <dnssecMaxRecordsAmount>0</dnssecMaxRecordsAmount>
                 <dnssecAlgorithms>
                    <array>
                       <item>6</item>
                       <item>8</item>
                       <item>10</item>
                       <item>12</item>
                       <item>13</item>
                       <item>14</item>
                    </array>
                 </dnssecAlgorithms>
              </item>
           </array>
        </results>
        <total>3</total>
     </data>
  </reply>
</openXML>
Retrieved from "https://doc.openprovider.eu/API_Module_Extension_searchExtensionRequest"
Views
Personal tools