API Module Domain searchDomainRequest

From Openprovider API documentation

(Difference between revisions)
Jump to: navigation, search
 
(33 intermediate revisions not shown)
Line 13: Line 13:
|'''Input'''
|'''Input'''
|
|
-
*limit
+
*[[API Format Limit|limit]] (''default value: 100, maximum value: 1000'')
-
*offset
+
*[[API Format Offset|offset]] (''default value: 0'')
-
*extension
+
*[[API Format Domain extension|extension]]
*domainNamePattern
*domainNamePattern
-
*contactHandle
+
*[[API Format Handle|contactHandle]] (will return domains with customer handle match of any handle type: owner, admin, tech or billing)
-
*nsGroupPattern
+
*nsGroupPattern (nameservers group name pattern)
-
*status
+
*[[API Format Domain Status|status]]
-
*withAdditionalData
+
*withAdditionalData (''default value: 0'')
 +
*orderBy (orders output by chosen parameter's value, i.e.: id, domainName, status, orderDate, etc.)
 +
*order (desc or asc)
|- style="vertical-align:top;"
|- style="vertical-align:top;"
|'''Output'''
|'''Output'''
Line 27: Line 29:
*orderDate
*orderDate
*activeDate
*activeDate
-
*expirationDate
+
*[[API Format expirationDate|expirationDate]]
-
*ownerHandle
+
*[[API Format expirationDateOpenprovider|expirationDateOpenprovider]]
-
*adminHandle
+
*[[API Format Handle|ownerHandle]]
-
*techHandle
+
*[[API Format Handle|adminHandle]]
-
*nsGroup
+
*[[API Format Handle|techHandle]]
 +
*[[API Format Handle|billingHandle]]
 +
*[[API Format Handle|resellerHandle]]
 +
*[[API Format nsGroup|nsGroup]]
*[[API Format Nameservers|nameServers]]
*[[API Format Nameservers|nameServers]]
-
*authCode
+
*[[API Format authCode|authCode]]
-
*status
+
*[[API Format Domain Status|status]]
-
*autoRenew
+
*[[API Format autorenew|autorenew]]
-
*locked
+
*[[API Format isLocked|isLocked]]
-
*type
+
*[[API Format useDomicile|useDomicile]]
-
*useDomicile
+
*[[API Format Transfer At|at]]
-
*[[API Format Additional Data Domain|additionalData]] (if withAdditionalData = true)
+
*[[API Format Additional Data|additionalData]] (if withAdditionalData = true)
 +
*registryDetails (if withRegistryDetails = true)
 +
*softQuarantineExpiryDate (if status=DEL or RRQ)
 +
*hardQuarantineExpiryDate (if status=DEL or RRQ)
 +
*restorableUntil (if status=DEL or RRQ)
|}
|}
Line 48: Line 57:
   ->setAuth(array('username' => 'username', 'password' => 'password'))
   ->setAuth(array('username' => 'username', 'password' => 'password'))
   ->setArgs(array(
   ->setArgs(array(
-
     'offset' => 50,
+
     'offset' => 50, //Will only return results if more than 50 domains found
     'limit'  => 25,
     'limit'  => 25,
     'contactHandle' => 'AH009176-US',
     'contactHandle' => 'AH009176-US',
-
     'domainNamePattern' => 'openprovider'
+
     'domainNamePattern' => 'openprovider',
 +
    'orderBy' => 'domainName',
 +
    'order' => 'desc'
   ));
   ));
===Raw XML===
===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"?>
  <?xml version="1.0" encoding="UTF-8"?>
-
  <openxml>
+
  <openXML>
   <credentials>
   <credentials>
     <username>username</username>
     <username>username</username>
     <password>password</password>
     <password>password</password>
   </credentials>
   </credentials>
-
   <searchdomainrequest>
+
   <searchDomainRequest>
     <extension>nl</extension>
     <extension>nl</extension>
     <limit>10</limit>
     <limit>10</limit>
     <offset>0</offset>
     <offset>0</offset>
-
     <orderby>domainName</orderby>
+
     <orderBy>domainName</orderBy>
     <order>desc</order>
     <order>desc</order>
-
   </searchdomainrequest>
+
   </searchDomainRequest>
-
  </openxml>
+
  </openXML>
  <?xml version="1.0" encoding="UTF-8"?>
  <?xml version="1.0" encoding="UTF-8"?>
-
  <openxml>
+
  <openXML>
   <reply>
   <reply>
-
     <code>0</code>
+
     <nowiki><code>0</code></nowiki>
     <desc>
     <desc>
     </desc>
     </desc>
Line 84: Line 96:
               <extension>nl</extension>
               <extension>nl</extension>
             </domain>
             </domain>
-
             <nameservers />
+
             <nameServers />
             <id>353146</id>
             <id>353146</id>
-
             <islockable>0</islockable>
+
             <isLockable>0</isLockable>
-
             <islocked>0</islocked>
+
             <isLocked>0</isLocked>
             <comments></comments>
             <comments></comments>
-
             <orderdate>2010-04-20 16:16:26</orderdate>
+
             <orderDate>2010-04-20 16:16:26</orderDate>
-
             <activedate>2010-04-20 16:16:29</activedate>
+
             <activeDate>2010-04-20 16:16:29</activeDate>
-
             <expirationdate>2011-04-20 14:16:28</expirationdate>
+
             <expirationDate>2011-04-20 14:16:28</expirationDate>
 +
            <expirationDateOpenprovider>2011-04-20 14:16:28</expirationDateOpenprovider>
             <status>ACT</status>
             <status>ACT</status>
-
             <canrenew>0</canrenew>
+
             <canRenew>0</canRenew>
-
             <autorenew>1</autorenew>
+
             <autoRenew>1</autoRenew>
-
             <ownerhandle>NL000115-NL</ownerhandle>
+
             <ownerHandle>NL000115-NL</ownerHandle>
-
             <adminhandle>NL000115-NL</adminhandle>
+
             <adminHandle>NL000115-NL</adminHandle>
-
             <techhandle>NL000115-NL</techhandle>
+
             <techHandle>NL000115-NL</techHandle>
-
             <nsgroup>dns-openprovider</nsgroup>
+
             <billingHandle>SR003891-NL</billingHandle>
 +
            <nsGroup>dns-openprovider</nsGroup>
             <type>NEW</type>
             <type>NEW</type>
-
             <authcode>sad08dfdsf</authcode>
+
             <authCode>sad08dfdsf</authCode>
-
             <authorizationcoderequired>0</authorizationcoderequired>
+
             <authorizationCodeRequired>0</authorizationCodeRequired>
-
             <tradeallowed>1</tradeallowed>
+
             <tradeAllowed>1</tradeAllowed>
-
             <restoreprice>70</restoreprice>
+
             <restorePrice>70</restorePrice>
-
             <usedomicile>0</usedomicile>
+
             <useDomicile>0</useDomicile>
-
             <ownername>
+
             <ownerName>
               <initials>N</initials>
               <initials>N</initials>
-
               <firstname>Nigel</firstname>
+
               <firstName>Nigel</firstName>
-
               <prefix>
+
               <prefix />
-
              </prefix>
+
               <lastName>Jones</lastName>
-
               <lastname>Jones</lastname>
+
             </ownername>
             </ownername>
-
             <ownercompanyname>Company Ltd</ownercompanyname>
+
             <ownerCompanyName>Company Ltd</ownerCompanyName>
           </item>
           </item>
           <item>
           <item>
Line 119: Line 132:
               <extension>nl</extension>
               <extension>nl</extension>
             </domain>
             </domain>
-
             <nameservers />
+
             <nameServers />
             <id>353163</id>
             <id>353163</id>
-
             <islockable>0</islockable>
+
             <isLockable>0</isLockable>
-
             <islocked>0</islocked>
+
             <isLocked>0</isLocked>
-
             <comments>
+
             <comments />
-
            </comments>
+
             <orderDate>2010-04-20 17:12:47</orderDate>
-
             <orderdate>2010-04-20 17:12:47</orderdate>
+
             <activeDate>2010-04-20 17:12:51</activeDate>
-
             <activedate>2010-04-20 17:12:51</activedate>
+
            <expirationDate>2011-04-20 15:12:50</expirationDate>
-
             <expirationdate>2011-04-20 15:12:50</expirationdate>
+
             <expirationDateOpenprovider>2011-04-20 15:12:50</expirationDateOpenprovider>
             <status>ACT</status>
             <status>ACT</status>
-
             <canrenew>0</canrenew>
+
             <canRenew>0</canRenew>
-
             <autorenew>1</autorenew>
+
             <autoRenew>1</autoRenew>
-
             <ownerhandle>GB000002-GB</ownerhandle>
+
             <ownerHandle>GB000002-GB</ownerHandle>
-
             <adminhandle>GB000002-GB</adminhandle>
+
             <adminHandle>GB000002-GB</adminHandle>
-
             <techhandle>GB000002-GB</techhandle>
+
             <techHandle>GB000002-GB</techHandle>
-
             <nsgroup>dns-openprovider</nsgroup>
+
             <billingHandle>SR003891-NL</billingHandle>
 +
            <nsGroup>dns-openprovider</nsGroup>
             <type>NEW</type>
             <type>NEW</type>
-
             <authcode>sad08dfdsf</authcode>
+
             <authCode>sad08dfdsf</authCode>
-
             <authorizationcoderequired>0</authorizationcoderequired>
+
             <authorizationCodeRequired>0</authorizationCodeRequired>
-
             <tradeallowed>1</tradeallowed>
+
             <tradeAllowed>1</tradeAllowed>
-
             <restoreprice>70</restoreprice>
+
             <restorePrice>70</restorePrice>
-
             <usedomicile>0</usedomicile>
+
             <useDomicile>0</useDomicile>
-
             <ownername>
+
             <ownerName>
               <initials>UK</initials>
               <initials>UK</initials>
-
               <firstname>Great</firstname>
+
               <firstName>Great</firstName>
-
               <prefix>
+
               <prefix />
-
              </prefix>
+
               <lastName>Britain</lastName>
-
               <lastname>Britain</lastname>
+
             </ownerName>
-
             </ownername>
+
             <ownerCompanyName></ownerCompanyName>
-
             <ownercompanyname></ownercompanyname>
+
           </item>
           </item>
           <item>
           <item>
Line 155: Line 168:
               <extension>nl</extension>
               <extension>nl</extension>
             </domain>
             </domain>
-
             <nameservers />
+
             <nameServers />
             <id>341105</id>
             <id>341105</id>
-
             <islockable>0</islockable>
+
             <isLockable>0</isLockable>
-
             <islocked>0</islocked>
+
             <isLocked>0</isLocked>
-
             <comments>
+
             <comments />
-
            </comments>
+
             <orderDate>2010-03-15 16:50:19</orderDate>
-
             <orderdate>2010-03-15 16:50:19</orderdate>
+
             <activeDate />
-
            <activedate>
+
             <expirationDate>2011-03-15 16:50:19</expirationDate>
-
             </activedate>
+
            <expirationDateOpenprovider />
-
             <expirationdate>2011-03-15 16:50:19</expirationdate>
+
             <status>FAI</status>
             <status>FAI</status>
-
             <canrenew>0</canrenew>
+
             <canRenew>0</canRenew>
-
             <autorenew>0</autorenew>
+
             <autoRenew>0</autoRenew>
-
             <ownerhandle>OH002766-NL</ownerhandle>
+
             <ownerHandle>OH002766-NL</ownerHandle>
-
             <adminhandle>OH002766-NL</adminhandle>
+
             <adminHandle>OH002766-NL</adminHandle>
-
             <techhandle>OH002766-NL</techhandle>
+
             <techHandle>OH002766-NL</techHandle>
-
             <nsgroup>opdrs4</nsgroup>
+
             <billingHandle>SR003891-NL</billingHandle>
 +
            <nsGroup>opdrs4</nsGroup>
             <type>NEW</type>
             <type>NEW</type>
-
             <authcode>88sdkjhf7</authcode>
+
             <authCode>88sdkjhf7</authCode>
-
             <authorizationcoderequired>0</authorizationcoderequired>
+
             <authorizationCodeRequired>0</authorizationCodeRequired>
-
             <tradeallowed>1</tradeallowed>
+
             <tradeAllowed>1</tradeAllowed>
-
             <restoreprice>70</restoreprice>
+
             <restorePrice>70</restorePrice>
-
             <usedomicile>0</usedomicile>
+
             <useDomicile>0</useDomicile>
-
             <ownername>
+
             <ownerName>
               <initials>I.</initials>
               <initials>I.</initials>
-
               <firstname>Ibrahim</firstname>
+
               <firstName>Ibrahim</firstName>
-
               <prefix></prefix>
+
               <prefix />
-
               <lastname>Smith</lastname>
+
               <lastName>Smith</lastName>
-
             </ownername>
+
             </ownerName>
-
             <ownercompanyname></ownercompanyname>
+
             <ownerCompanyName></ownerCompanyName>
           </item>
           </item>
         </array>
         </array>
Line 191: Line 204:
     </data>
     </data>
   </reply>
   </reply>
-
  </openxml>
+
  </openXML>

Current revision as of 05:57, 27 March 2019

Contents

Module Domain > Search

Module domain
Command name searchDomainRequest
Use Returns a list of domain objects matching search criteria
Input
  • limit (default value: 100, maximum value: 1000)
  • offset (default value: 0)
  • extension
  • domainNamePattern
  • contactHandle (will return domains with customer handle match of any handle type: owner, admin, tech or billing)
  • nsGroupPattern (nameservers group name pattern)
  • status
  • withAdditionalData (default value: 0)
  • orderBy (orders output by chosen parameter's value, i.e.: id, domainName, status, orderDate, etc.)
  • order (desc or asc)
Output Result set of domain details:

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('searchDomainRequest')
 ->setAuth(array('username' => 'username', 'password' => 'password'))
 ->setArgs(array(
   'offset' => 50, //Will only return results if more than 50 domains found
   'limit'  => 25,
   'contactHandle' => 'AH009176-US',
   'domainNamePattern' => 'openprovider',
   'orderBy' => 'domainName',
   'order' => 'desc'
 ));

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>
  <searchDomainRequest>
    <extension>nl</extension>
    <limit>10</limit>
    <offset>0</offset>
    <orderBy>domainName</orderBy>
    <order>desc</order>
  </searchDomainRequest>
</openXML>

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <reply>
    <code>0</code>
    <desc>
    </desc>
    <data>
      <results>
        <array>
          <item>
            <domain>
              <name>test-free-registration</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>353146</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments></comments>
            <orderDate>2010-04-20 16:16:26</orderDate>
            <activeDate>2010-04-20 16:16:29</activeDate>
            <expirationDate>2011-04-20 14:16:28</expirationDate>
            <expirationDateOpenprovider>2011-04-20 14:16:28</expirationDateOpenprovider>
            <status>ACT</status>
            <canRenew>0</canRenew>
            <autoRenew>1</autoRenew>
            <ownerHandle>NL000115-NL</ownerHandle>
            <adminHandle>NL000115-NL</adminHandle>
            <techHandle>NL000115-NL</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>dns-openprovider</nsGroup>
            <type>NEW</type>
            <authCode>sad08dfdsf</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>N</initials>
              <firstName>Nigel</firstName>
              <prefix />
              <lastName>Jones</lastName>
            </ownername>
            <ownerCompanyName>Company Ltd</ownerCompanyName>
          </item>
          <item>
            <domain>
              <name>test-free-domain</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>353163</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments />
            <orderDate>2010-04-20 17:12:47</orderDate>
            <activeDate>2010-04-20 17:12:51</activeDate>
            <expirationDate>2011-04-20 15:12:50</expirationDate>
            <expirationDateOpenprovider>2011-04-20 15:12:50</expirationDateOpenprovider>
            <status>ACT</status>
            <canRenew>0</canRenew>
            <autoRenew>1</autoRenew>
            <ownerHandle>GB000002-GB</ownerHandle>
            <adminHandle>GB000002-GB</adminHandle>
            <techHandle>GB000002-GB</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>dns-openprovider</nsGroup>
            <type>NEW</type>
            <authCode>sad08dfdsf</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>UK</initials>
              <firstName>Great</firstName>
              <prefix />
              <lastName>Britain</lastName>
            </ownerName>
            <ownerCompanyName></ownerCompanyName>
          </item>
          <item>
            <domain>
              <name>abcdefg</name>
              <extension>nl</extension>
            </domain>
            <nameServers />
            <id>341105</id>
            <isLockable>0</isLockable>
            <isLocked>0</isLocked>
            <comments />
            <orderDate>2010-03-15 16:50:19</orderDate>
            <activeDate />
            <expirationDate>2011-03-15 16:50:19</expirationDate>
            <expirationDateOpenprovider />
            <status>FAI</status>
            <canRenew>0</canRenew>
            <autoRenew>0</autoRenew>
            <ownerHandle>OH002766-NL</ownerHandle>
            <adminHandle>OH002766-NL</adminHandle>
            <techHandle>OH002766-NL</techHandle>
            <billingHandle>SR003891-NL</billingHandle>
            <nsGroup>opdrs4</nsGroup>
            <type>NEW</type>
            <authCode>88sdkjhf7</authCode>
            <authorizationCodeRequired>0</authorizationCodeRequired>
            <tradeAllowed>1</tradeAllowed>
            <restorePrice>70</restorePrice>
            <useDomicile>0</useDomicile>
            <ownerName>
              <initials>I.</initials>
              <firstName>Ibrahim</firstName>
              <prefix />
              <lastName>Smith</lastName>
            </ownerName>
            <ownerCompanyName></ownerCompanyName>
          </item>
        </array>
      </results>
      <total>3</total>
    </data>
  </reply>
</openXML>
Retrieved from "https://doc.openprovider.eu/API_Module_Domain_searchDomainRequest"
Views
Personal tools