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.

Operation	Description
getAllPosts	Retrieves all bookmarks.
addNewPost	Add new bookmark.
lastUpdatedTime	Returns the last updated time.
deletePost	Delete an existing bookmark
getPosts	Get bookmark for a single date, or fetch specific items
getRecentPosts	Fetch recent bookmarks
getAllPostsDates	List dates on which bookmarks were posted
postAllHashes	Returns 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"
    }
}

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 “CCYYMMDDThh: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"
    }
}

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"
    }
}

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"
    }
}

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 URLencode the argument value.
hashes : (optional) Fetch multiple bookmarks by one or more URL MD5s regardless of date, separated by URLencoded 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"
    }
}

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"
    }
}

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"
    }
}

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"
    }
}

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"
    }
}

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>

WSO2 ESB Connectors Documentation

Working with Posts in Delicious

Overview

Operation details

Retrieving all posts.

Properties

Sample request

Related Delicious documentation

Add New Post

Properties

Sample request

Related Delicious documentation

Getting last post time

Sample request

Related Delicious documentation

Delete a Post

Properties

Sample request

Related Delicious documentation

Getting posts .

Properties

Sample request

Related Delicious documentation

Get recent posts

Properties

Sample request

Related Delicious documentation

List of post dates with count

Properties

Sample request

Related Delicious documentation

Getting change manifest of all posts

Sample request

Related Delicious documentation

Get list of popular tags

Properties

Sample request

Related ActiveCollab documentation

Sample configuration