This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Working with Posts in Delicious



Overview

The following operations allow you to work with delicious. Click an operation name to see details on how to use it.

For a sample proxy service that illustrates how to work with posts, see Sample configuration.

OperationDescription

getAllPosts

Retrieves all bookmarks.

addNewPost
Add new bookmark.
lastUpdatedTimeReturns the last updated time.
deletePostDelete an existing bookmark
getPostsGet bookmark for a single date, or fetch specific items
getRecentPostsFetch recent bookmarks
getAllPostsDatesList dates on which bookmarks were posted
postAllHashesReturns a change manifest of all posts
suggestPopularTags

Returns a list of popular tags, recommended tags and network
tags for a user

Operation details 

This section provides further details on the operations related to getAllPosts.

Retrieving all posts.

The getAllPosts operation retrieves the all information of bookmarks.

getAllPosts
 <delicious.getAllPosts>
    <tag_separator>{$ctx:tag_separator}</tag_separator>
    <results>{$ctx:results}</results>
    <start>{$ctx:start}</start>
    <results>{$ctx:results}</results>
	<fromdt>{$ctx:fromdt}</fromdt>
	<todt>{$ctx:todt}</todt>
	<meta>{$ctx:meta}</meta>
 </delicious.getAllPosts> 
Properties
  • tag_separator : Returns tags separated by a comma, instead of a space character.

  • start : Start returning posts this many results into the set.

  • results : Return up to this many results.

  • fromdt : Filter for posts on this date or later.

  • todt : Filter for posts on this date or earlier.

  • meta : Include change detection signatures on each item in a ‘meta’ attribute.

Sample request

Following is a sample REST/JSON request that can be handled by the getAllPosts operation.

Sample Request for getAllPosts
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"getPosts",
    "testType":"optional",
    "tag_separator":"comma",
    "tag":"test",
    "meta":"yes"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsall

Add New Post

The addNewPost operation adds a new post to delicious.

addNewPost
 <delicious.addNewPost> 
     <url> {$ctx:url} </url> 
     <description>{$ctx:description}</description> 
     <extended>{$ctx:extended}</extended> 
     <tags>{$ctx:tags}</tags> 
     <dt>{$ctx:dt}</dt> 
     <replace>{$ctx:replace}</replace> 
     <shared>{$ctx:shared}</shared> 
</delicious.addNewPost> 
Properties
  • url : (required) The url of the item.
  • description : (required) The description of the item.
  • extended : (optional) Notes for the item.
  • tags : (optional) Tags for the item (comma delimited).
  • dt : (optional) Datestamp of the item (format “CCYY­MM­DDThh:mm:ssZ"). 
  • replace : (optional) Don’t replace post if given url has already been posted.
  • shared : (optional) Make the item private.
Sample request

Following is a sample REST/JSON request that can be handled by the addNewPost  operation.

Sample Request for addNewPost
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"addNewPost",
    "testType":"optional",
    "url ":"bookmarkurl",
    "description":"test_url",
    "extended":"test_extended",
    "tags":"test"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsadd

Getting last post time 

The lastUpdatedTime operation returns the last updated time for the user, as well as the number of new items in the user’s  inbox since it was last visited.

lastUpdatedTime
<delicious.lastUpdatedTime/> 
Sample request

Following is a sample REST/JSON request that can be handled by the lastUpdatedTime operation.

Sample Request for lastUpdatedTime
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"lastUpdatedTime"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsupdate

Delete a Post

The deletePost operation deletes a post to delicious.

deletePost
 <delicious.deletePost> 
     <url>{$ctx:url}</url> 
</delicious.deletePost> 
Properties
  • url : (required) The url of the item.
Sample request

Following is a sample REST/JSON request that can be handled by the deletePost  operation.

Sample Request for deletePost
 {"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"deletePost",
    "delUrl":"bookmarkurl"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsdelete

Getting posts .

The getPosts operation returns  one or more posts on  a single day matching the arguments.

getPosts
<delicious.getPosts> 
     <tag>{$ctx:tag}</tag> 
     <dt>{$ctx:dt}</dt> 
     <url>{$ctx:url}</url> 
     <hashes>{$ctx:hashes}</hashes> 
     <meta>{$ctx:meta}</meta> 
     <tag_separator>{$ctx:tag_separator}</tag_separator> 
</delicious.getPosts> 
Properties
  • tag : (optional) Filter by this tag.
  • dt: (optional) Filter by this date, defaults to the most recent date on which bookmarks were saved.
  • url : (optional) Fetch a bookmark for this URL, regardless of date.
  • Note : Be sure to URL­encode the argument value.
  • hashes : (optional) Fetch multiple bookmarks by one or more URL MD5s regardless of date, separated by URL­encoded spaces (i.e. ‘+’).
  • meta : yes (optional) Include change detection signatures on each item in a ‘meta’ attribute. Clients wishing to maintain a synchronized local store of bookmarks should retain the value of this attribute - its value will change when any significant field of the bookmark changes.
  • tag_separator : comma (optional) ­ Use commas instead of spaces to separate tags.
Sample request

Following is a sample REST/JSON request that can be handled by the getPosts  operation.

Sample Request for getPosts
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"getPosts",
    "testType":"optional",
    "tag_separator":"comma",
    "tag":"test",
    "meta":"yes"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsget

Get recent posts 

The getRecentPosts operation returns a list  of the most recent posts in delicious.

getRecentPosts
<delicious.getRecentPosts> 
    <tag>{$ctx:tag}</tag> 
    <count>{$ctx:count}</count> 
</delicious.getRecentPosts>
Properties
  • tag : (optional) Filter by this tag.
  • count: (optional) Number of items to retrieve (Default:15, Maximum:100).
Sample request

Following is a sample REST/JSON request that can be handled by the getRecentPosts  operation.

Sample Request for getRecentPosts
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"getRecentPosts",
    "testType":"optional",
    "tag":"test",
    "count":"1"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsrecent

List  of  post dates with count 

The getAllPostsDates operation adds a new bookmark.

getAllPostsDates
 <delicious.getAllPostsDates> 
    <tag>{$ctx:tag}</tag> 
</delicious.getAllPostsDates> 
Properties
  • tag : (optional) Filter by this tag.
Sample request

Following is a sample REST/JSON request that can be handled by the getAllPostsDates  operation.

Sample Request for getAllPostsDates
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"getDates",
    "testType":"optional",
    "tag":"test"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsdates

Getting change manifest of all posts 

The postAllHashes operation use to get a change manifest of all posts.

postAllHashes
</delicious.postAllHashes>
Sample request

Following is a sample REST/JSON request that can be handled by the postAllHashes  operation.

Sample Request for postAllHashes
{
 "json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"postAllHashes"
    }
}
Related Delicious documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postsallhashes

Get list of popular tags 

The suggestPopularTags operation retrieves a list of popular tags.

suggestPopularTags
<delicious.suggestPopularTags> 
    <url>{$ctx:url} </url> 
<delicious.suggestPopularTags/>
Properties
  • url : (required) The url of the item.
Sample request

Following is a sample REST/JSON request that can be handled by the suggestPopularTags  operation.

Sample Request for suggestPopularTags
{"json_payload":
    {
    "username":"wso2delicious",
    "password":"!2qwasZX",
    "Apiurl":"https://api.del.icio.us",
    "method":"suggestPopularTags",
    "url":"www.yahoo.com"
    }
}
Related ActiveCollab documentation

https://github.com/SciDevs/delicious-api/blob/master/api/posts.md#v1postssuggest

Sample configuration

Following is a sample proxy service that illustrates how to connect to Delicious with the init operation and use the getAllPosts operation. The sample request for this proxy can be found in getAllPosts sample request  . You can use this sample as a template for using other operations in this category.

Sample Proxy
<proxy xmlns="http://ws.apache.org/ns/synapse"
       name="delicious_getAllPosts"
       transports="https,http"
       statistics="disable"
       trace="disable"
       startOnLoad="true">
   <target>
      <inSequence>
		 <property name="client_id" expression="json-eval($.json_payload.client_id)"/>
	 	 <property name="client_secret" expression="json-eval($.json_payload.client_secret)"/>
		 <property name="authType" expression="json-eval($.json_payload.authType)"/>
		 <property name="uri" expression="json-eval($.json_payload.Apiurl)"/>
		 <property name="password" expression="json-eval($.json_payload.password)"/>
		 <property name="username" expression="json-eval($.json_payload.username)"/>
         <property name="tag_separator" expression="json-eval($.tag_separator)"/>
         <property name="start" expression="json-eval($.start)"/>
         <property name="results" expression="json-eval($.results)"/>
         <property name="fromdt" expression="json-eval($.fromdt)"/>
         <property name="todt" expression="json-eval($.todt)"/>
         <property name="meta" expression="json-eval($.meta)"/>         
   <delicious.init>
    <client_id>{$ctx:client_id}</client_id>
    <client_secret>{$ctx:client_secret}</client_secret>
    <username>{$ctx:username}</username>
    <password>{$ctx:password}</password>
    <authType>{$ctx:authType}</authType>
    <uri>{$ctx:uri}</uri>
 </delicious.init>  
 <delicious.getAllPosts>  
 	<tag_separator>{$ctx:tag_separator}</tag_separator> 
  	<tag>{$ctx:tag}</tag> 
  	<start>{$ctx:start}</start> 
  	<results>{$ctx:results}</results> 
  	<fromdt>{$ctx:fromdt} </fromdt> 
  	<todt> {$ctx:todt} </todt> 
 	<meta>{$ctx:meta} </meta> 
 </delicious.getAllPosts> 
         <respond/>
      </inSequence>
      <outSequence>
         <send/>
      </outSequence>
   </target>
   <description/>
</proxy>