Skip to content

laBecasse/shaarli-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shaarli-client

a client in node.js for a shaarli api.

Installing

To utilize shaarli-client, install the the npm module:

npm install shaarli-client

After installing the npm package you can now start request shaarli instance like so:

var shaarliClient = require('shaarli-client');

var client = new shaarliClient(url,secret);

Get Info

Get information about this instance.

client.getInfo(function(err,info){
	console.log(info);
})

Get Links

Get a collection of links ordered by creation date.

params is a collection wich can have the following keys:

  • offset (int) - Offset from which to start listing links
  • limit (int | "all") - Number of links to retrieve or 'all'
  • searchtags (Array) - List of tags
  • searchterm (Array) - Search terms across all links fields
  • visibility ("all" | "private" | "public") - Filter links by visibility
var params = {
	"offset": 0,
	"limit": 10,
	"searchtags": ["gif","cat"],
	"searchterm": ["looks","at"],
	"visibility": "all"
};

client.getLinks(params,function(err,links){
	console.log(links);
})

Get Link

Get a link with its id.

client.getLink(id,function(err,link){
	console.log(link);
})

Post Link

Create a new link or note.

params is a collection wich can have the following keys:

  • description (string) - Link description
  • private (boolean) - Link visibility
  • tags (Array) - List of tags associated with the link
  • title (string) - Link title
  • url (string) - Link URL
var params = {
	"description": "blabla",
	"private": false,
	"tags": ["cat","image"],
	"title": "jumping cats",
	"url": "http://jumpin.cat/"
};

client.postLink(params,function(err,newLink){
	console.log(newLink);
});

Put Link

Update an existing link with provided request data. Keep in mind that all link’s fields will be updated.

params is a collection wich can have the following keys:

  • description (string) - Link description
  • private (boolean) - Link visibility
  • tags (Array) - List of tags associated with the link
  • title (string) - Link title
  • url (string) - Link URL
var params = {
	"description": "bloblo",
	"private": false,
	"tags": ["image","truc"],
	"title": "jumping cats calendar",
	"url": "http://jumpin.cat/post"
};

client.putLink(id,params,function(err,updateLink){
	console.log(updateLink);
});

Delete Link

Delete a link.

client.deleteLink(id,function(err){
});

Get Tags

Get a collection of tags

params is a collection wich can have the following keys:

  • offset (int) - Offset from which to start listing tags
  • limit (int | "all") - Number of tags to retrieve or 'all'
  • visibility ("all" | "private" | "public") - Filter tags by visibility
var params = {
	"offset": 0,
	"limit": 10,
	"visibility": "private"
};

client.getTags(params,function(err,tags){
	console.log(tags);
})

Get Tag

Get a tag with its tagName.

client.getTag(tagName,function(err,tag){
	console.log(tag);
})

Put Tag

Rename an existing tag.

params is a collection wich can have the following keys:

  • name (string) - new tag name
var params = {
	"name": "kitty"
};

client.putTag(tagName, params, function(err, updateTag){
	console.log(updateTag);
});

Delete Tag

Delete a tag.

client.deleteTag(tagName,function(err){
});

Get History

Retrieve the last actions made by the user, even in the web version, including:

  • CREATED: A new link has been created.
  • UPDATED: An existing link has been updated.
  • DELETED: A link has been deleted.
  • SETTINGS: Shaarli settings have been updated.

params is a collection wich can have the following keys:

  • since (string) - Get all event since this datetime (format ISO ISO8601). Note: the + should be encoded to %2B.
  • offset (int) - Offset from which to start listing events
  • limit (int | "all") - Number of event to retrieve or 'all'
var params = {
    "since": "2015-05-05T12:30:00%2B03:00",
	"offset": 0,
	"limit": 10,
};

client.getHistory(params, function(err, history){
	console.log(history);
});

Releases

No releases published

Packages

No packages published