Developers, connect your app to wallabag via oAuth2

We finally implement oAuth2 in wallabag v2.

This blog post is here to explain to you how you can integrate your application to wallabag v2.

For each call to our API, you need a token. If you do a call without token, you will have this message: OAuth2 authentication required.

For example, try this command:

NOTE: the following commands make use of the HTTPie library. Make sure it is installed on your system before using it.

http GET

To create a token for a given user, you need a client id and a client secret. As we are still in alpha, we create a client for you (but in few weeks, each application will have its own client id and client secret).

For the existing user nicosomb/nicolas, you can do this call:

http POST

The API will return a response like this:

HTTP/1.1 200 OK Cache-Control: no-store, private Connection: close Content-Type: application/json Date: Tue, 06 Oct 2015 18:24:03 GMT Host: localhost:8000 Pragma: no-cache X-Debug-Token: be00a1 X-Debug-Token-Link: /profiler/be00a1 X-Powered-By: PHP/5.5.9-1ubuntu4.13 { "access_token": "ZWFjNjA3ZWMwYWVmYzRkYTBlMmQ3NTllYmVhOGJiZDE0ZTg1NjE4MjczOTVlNzM0ZTRlMWQ0MmRlMmYwNTk5Mw", "expires_in": 3600, "refresh_token": "ODBjODU1NWUwNmUzZTBkNDQ5YWVlZTVlMjQ2Y2I0OWM2NTM1ZGM2M2Y3MDhjMTViM2U2MzYxYzRkMDk5ODRlZg", "scope": null, "token_type": "bearer" }

The access_token is useful to do a call to the API endpoint. For example:

http GET
"Authorization:Bearer Yzk1MDk1YmE3NjE0OTMwMTgxODc5ODdlODMwNDIxYzlhOWMxNzY3N2Q0ZjZjMjFkNTRjYzAxMjgxZTlmNmJmNg"

This call will return all the entries for nicosomb.

You can create your own user on for your tests.

If you want to see all the API endpoints, you can have a look to our API documentation:
We will have more endpoints in few weeks if necessary.

If you have some problems with the API, feel free to create a new issue on GitHub.

wallabag 2.0.0-alpha.1 available wallabag 2.0.0-alpha, finally

Want to give it a try?


Last release: wallabag 2.6.6
(md5 checksum: ed38e97b0fb8b23745ef8f58b978f440)
You can download our previous releases here.