This repository has been archived by the owner on Dec 1, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 2
API
mcansky edited this page Jan 29, 2011
·
3 revisions
Mjölk Api is based on the Delicious api to simplify clients development.
- posts/update - Check to see when a user last posted an item.
- 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.
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
Delete one bookmark. url : host/v1/posts/delete
- url : url (string, required)
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
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)
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/get - fetch all tags [TODO]
- tags/delete - delete a tag from all posts [TODO]
- tags/rename - rename a tag on all posts [TODO]
- 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]