Add an API for search/add/edit/delete link

[leblanc-simon]

This pull request add an REST API to Shaarli

Documentation and tests : https://gist.github.com/leblanc-simon/6137511

[octplane]

Nice !

[nodiscc]

This could provide a good base for a Firefox addon that syncs shaarli to the local browser bookmarks.

[Phyks]

+1, I'd like to interface my shaarli with some other services and I definitely need something like this :)

[Phyks]

@leblanc-simon : This API is really nice. Although, I have two ideas to enhance it:

• The token should appear explicitly somewhere in the interface, in the options for example. For now, it is not clear which value is what, and to understand how to get the token.
• You should remove the empty test in checkParams, especially for the token. I wrote a python script using a config file, and in the default config file there was no token specified. I was trying to post new links, but my script did not fail because I did not have any token (I expected it to fail, but the request had a 200 status code because it was returning the search results).

[Phyks]

Note : Note that the position of the arguments in the request actually matters. At least, first one has to be do=api.

[nodiscc]

@leblanc-simon @octplane @Phyks Followup to this discussion here: shaarli#16

Your comments are welcome.

By the way this is a large change and adds a lot of complexity to the current code, and it was agreed that Shaarli's core code should be KISS. So this needs to be implemented as a a plugin (proposal/discussion: shaarli#14) or we should use RSS/POST resquests as suggested in shaarli#16.

[virtualtam]

REST API on the Shaarli community fork:

• specification: https://github.com/shaarli/api-documentation , view as HTML at http://shaarli.github.io/api-documentation/
• implementation: Expose an API for Shaarli shaarli/Shaarli#609