Skip to content
This repository has been archived by the owner on Dec 1, 2020. It is now read-only.
mcansky edited this page Jan 29, 2011 · 3 revisions

Mjölk Api is based on the Delicious api to simplify clients development.

Update

  • posts/update - Check to see when a user last posted an item.

Posts

  • posts/add - add a new bookmark [DONE]
  • posts/delete - delete an existing bookmark [DONE]
  • posts/get - get bookmark for a single date, or fetch specific items [DONE]
  • posts/dates - list dates on which bookmarks were posted [TODO]
  • posts/recent - fetch recent bookmarks [DONE]
  • posts/all - fetch all bookmarks by date or index range [DONE]
  • posts/all?hashes - fetch a change detection manifest of all items [TODO]
  • posts/suggest - fetch popular, recommended and network tags for a specific url [TODO]

Automatically generated rdoc for posts is hosted by rdoc.info.

posts/add

Add a bookmark. url : host/v1/posts/add

  • url : url (string, required)
  • description : (text, required)
  • tags : none or more (text, required)
  • dt : date (date time, optionnal)
  • shared : yes/no (optionnal, yes by default, means it's public by default)
  • not implemented : replace, extended

posts/delete

Delete one bookmark. url : host/v1/posts/delete

  • url : url (string, required)

posts/get

Get a bookmark or a group of bookmarks. url : host/v1/posts/get

  • tag : {TAG} + {TAG} + {TAG} ... optionnal
  • dt (date) : {CCYY-MM-DDThh:mm:ssZ} optionnal
  • url : fetch bookmark with that url optionnal
  • hashes: fetch bookmarks using their url hashes as key (md5) optionnal [TODO]
  • meta (boolean): include change detection meta for each item optionnal

posts/recent

Return a list of recent posts. url: host/v1/posts/recent

  • tag = {TAG} tag to filter optionnal
  • count = 1..100 number of posts to return (default 15, max 100)

posts/all

Return all bookmarks by date or index. url host/v1/posts/all

  • tag : filter by tag (list ok) optionnal
  • start : number from where to start in the results optionnal
  • results : number limit for results optionnal
  • fromdt : date from which posts should be taken optionnal
  • todt : date to which posts should be taken optionnal
  • meta : include meta for posts optionnal

Tags

  • tags/get - fetch all tags [TODO]
  • tags/delete - delete a tag from all posts [TODO]
  • tags/rename - rename a tag on all posts [TODO]

Tag Bundles

  • tags/bundles/all - fetch tag bundles [TODO]
  • tags/bundles/set - assign a set of tags to a bundle [TODO]
  • tags/bundles/delete - delete a tag bundle [TODO]
Clone this wiki locally