Método Posts

http://links.sapo.pt/api/posts/get?

Devolve o post ou posts de um determinado dia segundo o critério dos parâmetros de entrada. Se não for dada uma data ou um url, são devolvidos os mais recentes do dia actual

Parâmetros

&tag (opcional). Filtrar por esta Tag.
&dt (opcional). Filtrar por esta Data (CCYY-MM-DDThh:mm:ssZ).
&url (opcional). Filtrar por este Url.

Exemplo da resposta

<posts dt="2005-11-28" tag="webdev" user="user">
  <post href="http://www.howtocreate.co.uk/tutorials/texterise.php?dom=1" 
  description="JavaScript DOM reference" 
  extended="dom reference" 
  relation="1234" 
  object="1234" 
  hash="c0238dc0c44f07daedd9a1fd9bbdeebd" 
  others="55" tag="dom javascript webdev" time="2005-11-28T05:26:09Z" />
</posts>

http://links.sapo.pt/api/posts/recent?

Devolve uma lista dos posts mais recentes, filtrados. Máximo de 100.

Parâmetros

&tag (opcional). Filtrar por esta Tag.
&count (opcional). Número máximo de items na resposta (por defeito: 15, máximode 100).

Exemplo da resposta

<posts tag="" user="user">
  <post href="http://www.weather.com/" description="weather.com" 
  relation="1234" 
  object="1234" 
  hash="6cfedbe75f413c56b6ce79e6fa102aba" tag="weather reference" 
  time="2005-11-29T20:30:47Z" />
  <post href="http://www.nytimes.com/" 
  description="The New York Times - Breaking News, World News & Multimedia" 
  extended="requires login" hash="ca1e6357399774951eed4628d69eb84b" 
  tag="news media" time="2005-11-29T20:30:05Z" />
</posts>

http://links.sapo.pt/api/posts/all?

Devolve todos os posts. Use com moderação. Utilize em conjunto com o método update para saber se deve pedir alguma actualização.

Parâmetros

&tag (opcional). Filtrar por esta Tag.

Exemplo da resposta

<posts tag="" user="user">
  <post href="http://www.weather.com/" description="weather.com" 
  relation="1234" 
  object="1234" 
  hash="6cfedbe75f413c56b6ce79e6fa102aba" tag="weather reference" 
  time="2005-11-29T20:30:47Z" />
  <post href="http://www.nytimes.com/" 
  description="The New York Times - Breaking News, World News & Multimedia" 
  extended="requires login" hash="ca1e6357399774951eed4628d69eb84b" 
  tag="news media" time="2005-11-29T20:30:05Z" />
</posts>

http://links.sapo.pt/api/posts/dates?

Devolve uma lista de datas com o número de posts por cada data.

Parâmetros

&tag (opcional). Filtrar por esta Tag.

Exemplo da resposta

<dates tag="" user="user">
  <date count="5" date="2005-11-29" />
  <date count="15" date="2005-11-28" />
  <date count="2" date="2005-11-26" />
  <date count="2" date="2005-11-25" />
  <date count="7" date="2005-11-23" />
  <date count="20" date="2005-11-22" />
  <date count="16" date="2005-11-21" />
  <date count="4" date="2005-11-19" />
</dates>

http://links.sapo.pt/api/posts/add?

Adicionar um Url (post) a links.sapo.pt

Parâmetros

&url (obrigatório) - O Url do item a ser adicionado.
&description (obrigatório) - A Descrição do item.
&extended (opcional) - As Observações do item.
&tags (opcional) - As Tags para este item (separados por espaços).
&dt (opcional) - Data do item (formato "CCYY-MM-DDThh:mm:ssZ").
Precisa do LITERAL "T" e "Z" com especifica o ISO8601 em http://www.cl.cam.ac.uk/~mgk25/iso-time.html por exemplo: "1984-09-01T14:21:31Z"
&replace=no (opcional) - Não substitui o post se o Url já existir na lista do utilizador.
&shared=no (opcional) - Item privado. Os outros utilizadores não o podem ver.

Exemplo da resposta

Se o post for bem sucedido:

<result code="done" relation="id" object="id" hash="string" screen="name" />

Se o post falhar:

<result code="something went wrong" />

http://links.sapo.pt/api/posts/delete?

Apagar o Url (post) de links.sapo.pt

Parâmetros

&url (obrigatório) - O Url do item.

Exemplo da resposta

<result code="done" />