segunda-feira, 11 de maio de 2009

API++

A API de pesquisa do Destakes ganhou dois novos modos de pesquisa, o extended e o boolean.

Note-se que o que vou referir aqui não se aplica à pesquisa no site, essa _ainda_ é do século passado.

Até agora as pesquisas que se podiam fazer eram simples. Pesquisava-se por um ou mais termos e no limite podia-se dizer que a pesquisa tinha de ter todos os termos, alguns dos termos ou todos os termos nessa ordem precisa. No entanto, se por exemplo quisesse pesquisar por um termo e omitir ao mesmo tempo dos resultados um outro, não podia.

Não vou entrar em muitas explicações, se as quiserem enviem um email para info@destakes.com com o que pretendem fazer, no entanto, aqui ficam umas dicas.

Modo boolean
Este modo introduz mais umas coisas nas pesquisas por termos singulares
hello & world (têm de existir os dois termos)
hello | world (tem de existir um dos dois)
hello - world (existe o hello e não o world)
(hello world) | sad (têm de existir os dois termos ou então o outro. Exsite sempre um & implicito, ou seja, hello world e hello & world significam o mesmo.

Modo extended
Isto acrescenta mais uns posinhos, e permite que a query já seja algo do género.
("Pinto da Costa" | "Jesualdo Ferreira") & -"Carolina Salgado"
Quero dizer, um ou outro, desde que não falem dela. :-)

Isto é baseado no Sphinx, logo a documentação e todos os detalhes sobre sobre Boolean query syntax e Extended query syntax aplica-se. ;-)

Adicionalmente, e para todos os modos, agora também se podem limitar as pesquisas no tempo. Os argumentos a usar são o minDate e o maxDate. Exemplo, se quiser as notícias que saíram sobre o Google mas só entre Janeiro e Fevereiro deste ano, usaria /search/?q=google&minDate=200902&maxDate=200902

And that's it... na prática podem-se fazer coisas giras com isto. A título de exemplo, a secção de Bolsa, Futebol, Cinema, os Dossiers especiais e a própria pesquisa, passaram a usar exclusivamente a API.

ps: quando arranjar tempo adiciono isto ao texto da página da API. Shame on me. :-/

1 comentário:

Anónimo disse...

Tens ali um typo.
Nao é Exsite mas sim Existe :)

Keep the good work,
Latvia