Destakes

Destakes Web Services

Pesquisa de notícias
Este web service quando invocado, permite a pesquisa de notícias por um dado termo.
A pesquisa(q) é efectuada sobre o título e descrição das notícias.
O tipo de pesquisa (match) pode ser de três tipos. 'all' em que todos os termos têm de estar presentes independentemente da ordem. 'any' (por omissão) em que nem todos os termos termos têm que estar presentes independentemente da ordem. 'phrase' em que os termos têm de estar presentes exactamente como estão, nas posições em que estão, ou seja, dependente da ordem em que se apresentam.
A ordenação (order) caso omissa é efectuada pela data da notícia.
O formato (format) caso omisso será RSS 2.0
O número de elementos retornado(limit) são 20 a não ser que especificado outro valor.
Segue-se um exemplo de pedido e resposta para HTTP GET. Os marcadores de posição apresentados necessitam de ser substituídos por valores reais.

GET /search/?q=string&sort=[relevance|date]&match=[all|any|phrase]&page=[integer]&limit=[integer]&format=[xml|rss|json]
Host: api.destakes.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
...

Pesquisa de notícias relacionadas

GET /related/?q=string&match=[all|any|phrase]&page=[integer]&limit=[integer]&format=[xml|rss|json]
Host: api.destakes.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
...

Listagem de fontes

GET /sources/
Host: api.destakes.com

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
...