API do SAPO Links
- O entry-point deste Web-service é http://links.sapo.mz/api
- Tudo o que está em /api usa HTTP-Auth como método de autenticação.
- As credênciais utilizadas na autenticação são o E-Mail ou o Nickname e a Password do utilizador.
- Este documento e a APIs aqui expostos estão sujeitos a alterações.
- Neste momento (3-Jul-2006) este API é completamente compatível com o API do Del.icio.us, é possível utilizar aplicações feitas para o anterior com a simples alteração do entry-point do API
Notas importantes:
- Por favor espere PELO MENOS UM SEGUNDO entre pedidos, ou sujeita-se a ser automaticamente bloqueado. Se fizer uma library para reutilizar esta API não se esqueça deste requisito. Se usa uma library feita por terceiros, certifique-se que a mesma cumpre esta regra.
- Por favor esteja atento a erros 503 e respeite-os apropriadamente. Significa que está a ser bloqueado pelo SAPO Links
- Diga-nos através do (info.tags@mail.sapo.pt) se pensa distribuir software que use este API para que possamos pelo menos estar mais atentos e testar as coisas antecipadamente.
- Por favor use um User-Agent personalizado para o identificarmos facilmente, se precisarmos. Os identificadores habituais do tipo "Java/1.4.3" ou "lwp-perl" podem ser banidos ocasionalmente.
- Se vai distribuir código para outros utilizadores, a sua aplicação NÃO PODE adicionar quaisquer links sem a permissão explícita do utilizador. Da mesma forma, NÃO PODE modificar qualquer url excepto se o utilizador o autorizar.
Método disponíveis
- Update - Verifica quando é que um utilizador fez um post pelo última vez
- Tags - Pede uma lista das tags, faz rename.
- Posts - Pede uma lista dos posts (urls), adiciona, apaga.
- Colectâneas - Pede lista das Colectâneas, cria, apaga.