Se è necessario eseguire una ricerca semplice, è possibile utilizzare il metodo SearchService.SimpleSearch. Consente di cercare articoli che contengono un testo specifico e appartengono a una determinata categoria. Potrai specificare i valori di paging e un'opzione di ordinamento .
Il parametro SimpleSearch contiene i seguenti campi:
- CategoryId: la cateogia di origin
- SearchText: Il testo verrà cercato nei titoli e nelle descrizioni.
- Language: La lingua degli articoli (esempio: tedesco, francese, italiano, entrambi)
- PageSize: Il numero di articoli per pagina
- PageNumber: L'indice della pagina
- SortBy: La colonna a cui sarà applicato l'ordinamento
- AscendingSort: Impostare a true per ordinare in ordine crescente (false per discendente)
- CategoryInfos: Impostato su true per recuperare il numero di articoli per categoria
JSON Example
- POST https://ws.ricardo.ch/ricardoapi/SearchService.Json.svc/SimpleSearch HTTP/1.1
- Content-Type: application/json
- Ricardo-Username: [YOUR TokenCredential]
- Host: ws.betaqxl.com
{
"simpleSearchParameter": {
"AscendingSort": true,
"CategoryId": 1,
"CategoryInfos": true,
"Language": 1,
"PageNumber": 1,
"PageSize": 10,
"SearchText": "test",
"SortBy": 0
}
}
SOAP Example
- POST https://ws.ricardo.ch/RicardoApi/SearchService.Soap.svc HTTP/1.1
- Content-Type: application/soap+xml; charset=utf-8
- Host: ws.betaqxl.com
- Accept-Encoding: gzip, deflat
<s:Envelope xmlns:a="http://www.w3.org/2005/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<s:Header>
<a:Action s:mustUnderstand="1">http://ricardo.contracts/ISearchService/SimpleSearch</a:Action>
<a:MessageID>urn:uuid:82134e38-5a82-41f1-9b70-c2d1ef6061d0</a:MessageID>
<a:ReplyTo>
<a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address>
</a:ReplyTo>
<Security xmlns="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<UsernameToken>
<Username>YOUR TOKEN</Username>
<Password></Password>
</UsernameToken>
</Security>
</s:Header>
<s:Body>
<SimpleSearch xmlns="http://ricardo.contracts">
<simpleSearchParameter xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<AscendingSort>true</AscendingSort>
<CategoryId>1</CategoryId>
<CategoryInfos>true</CategoryInfos>
<Language>SwitzerlandFrAndDe</Language>
<PageNumber>1</PageNumber>
<PageSize>10</PageSize>
<SearchText>test</SearchText>
<SortBy>Default</SortBy>
</simpleSearchParameter>
</SimpleSearch>
</s:Body>
</s:Envelope>