Page Comparison

...

...

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.

Add new bookmark.

Operation details 

Anchor
getAllPosts getAllPosts

Retrieving all posts.

The getAllPosts operation retrieves the all information of bookmarks.

 <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.

Anchor
request request

Sample request

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

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

Anchor
addNewPost addNewPost

Add New Post

The addNewPost operation adds a new post to delicious.

 <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.

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

Anchor
lastUpdatedTime lastUpdatedTime

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.

<delicious.lastUpdatedTime/> 

Sample request

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

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

Anchor
deletePost deletePost

Delete a Post

The deletePost operation deletes a post to delicious.

 <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.

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

Anchor
getPosts getPosts

Getting posts .

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

<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.

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

Anchor
getRecentPosts getRecentPosts

Get recent posts 

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

<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.

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

Anchor
getAllPostsDates getAllPostsDates

List  of  post dates with count 

The getAllPostsDates operation adds a new bookmark.

 <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.

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

Anchor
postAllHashes postAllHashes

Getting change manifest of all posts 

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

</delicious.postAllHashes>

Sample request

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

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

Anchor
suggestPopularTags suggestPopularTags

Get list of popular tags 

The suggestPopularTags operation retrieves a list of popular tags.

<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.

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

Anchor
sampleconfiguration sampleconfiguration

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.

Code Block
language xml title 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>