API Module Domain searchDomainRequest
From Openprovider API documentation
(Difference between revisions)
(30 intermediate revisions not shown) | |||
Line 13: | Line 13: | ||
|'''Input''' | |'''Input''' | ||
| | | | ||
- | *limit ''default value: 100'' | + | *[[API Format Limit|limit]] (''default value: 100, maximum value: 1000'') |
- | *offset ''default value: 0'' | + | *[[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 ''default value: 0'' | + | *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]] |
- | * | + | *[[API Format autorenew|autorenew]] |
- | * | + | *[[API Format isLocked|isLocked]] |
- | * | + | *[[API Format useDomicile|useDomicile]] |
- | * | + | *[[API Format Transfer At|at]] |
- | *[[API Format Additional Data | + | *[[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> | ||
Line 73: | Line 85: | ||
<openXML> | <openXML> | ||
<reply> | <reply> | ||
- | <code>0</code> | + | <nowiki><code>0</code></nowiki> |
<desc> | <desc> | ||
</desc> | </desc> | ||
Line 92: | Line 104: | ||
<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> | ||
Line 98: | Line 111: | ||
<adminHandle>NL000115-NL</adminHandle> | <adminHandle>NL000115-NL</adminHandle> | ||
<techHandle>NL000115-NL</techHandle> | <techHandle>NL000115-NL</techHandle> | ||
+ | <billingHandle>SR003891-NL</billingHandle> | ||
<nsGroup>dns-openprovider</nsGroup> | <nsGroup>dns-openprovider</nsGroup> | ||
<type>NEW</type> | <type>NEW</type> | ||
Line 125: | Line 139: | ||
<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> |
+ | <expirationDateOpenprovider>2011-04-20 15:12:50</expirationDateOpenprovider> | ||
<status>ACT</status> | <status>ACT</status> | ||
<canRenew>0</canRenew> | <canRenew>0</canRenew> | ||
Line 132: | Line 147: | ||
<adminHandle>GB000002-GB</adminHandle> | <adminHandle>GB000002-GB</adminHandle> | ||
<techHandle>GB000002-GB</techHandle> | <techHandle>GB000002-GB</techHandle> | ||
+ | <billingHandle>SR003891-NL</billingHandle> | ||
<nsGroup>dns-openprovider</nsGroup> | <nsGroup>dns-openprovider</nsGroup> | ||
<type>NEW</type> | <type>NEW</type> | ||
Line 160: | Line 176: | ||
<activeDate /> | <activeDate /> | ||
<expirationDate>2011-03-15 16:50:19</expirationDate> | <expirationDate>2011-03-15 16:50:19</expirationDate> | ||
+ | <expirationDateOpenprovider /> | ||
<status>FAI</status> | <status>FAI</status> | ||
<canRenew>0</canRenew> | <canRenew>0</canRenew> | ||
Line 166: | Line 183: | ||
<adminHandle>OH002766-NL</adminHandle> | <adminHandle>OH002766-NL</adminHandle> | ||
<techHandle>OH002766-NL</techHandle> | <techHandle>OH002766-NL</techHandle> | ||
+ | <billingHandle>SR003891-NL</billingHandle> | ||
<nsGroup>opdrs4</nsGroup> | <nsGroup>opdrs4</nsGroup> | ||
<type>NEW</type> | <type>NEW</type> |
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 |
|
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>