Api account
This API allows you to use all the shr.im features on your site. Post a link, edit or delete it, through the detailed information of a link...
All proposed functions Requires Authentication (just register with his Twitter account, and request an API key).
Sample Query API : http://shr.im/api/1.0/popular.json?api_user=your_nick&api_key=your_key
Obviously you need to replace api_user / api_key to your username / key for this to work.
You need to login with your Twitter account for request a API account.
Documentation
public_timeline Get last links posted
- URL : http://shr.im/api/1.0/public_timeline.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
home_timeline Get your links
- URL : http://shr.im/api/1.0/home_timeline.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
popular Top links right now
- URL : http://shr.im/api/1.0/popular.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
view Detailed information of a link
- URL : http://shr.im/api/1.0/view.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- alias (required) : unique identifier of the link (i.e : "test20" for shr.im/apistats)
by_domain Display links by domain
- URL : http://shr.im/api/1.0/by_domain.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- domain (required) : URL of domain (i.e : digg.com, news.cnet.com)
by_user Display links by user
- URL : http://shr.im/api/1.0/by_user.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- user (required) : username of user (i.e : shr_im, nephthys)
post Post a new link
- URL : http://shr.im/api/1.0/post.format
- Formats : xml, json, text
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- url_src (required) : URL of the link
- url_min (optional) : unique identifier of the link
- is_private (optional) : public (0, default) or private (1)
edit Edit a link
- URL : http://shr.im/api/1.0/edit.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- url_min (required) : identifier of the link to edit
- url_src (required) : new URL of the link
delete Delete a link
- URL : http://shr.im/api/1.0/delete.format
- Formats : xml, json
- HTTP Method : GET
- Requires Authentication : yes
- Parameters :
- url_min (required) : identifier of the link to delete
