{% extends "WallabagCoreBundle::layout.html.twig" %} {% block title %}{% trans %}How to create my first application{% endtrans %}{% endblock %} {% block css %} {{ parent() }} {% endblock %} {% block content %}

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

You need a token to communicate between your 3rd application and wallabag API.

To create this token, you need to create a new client.

Now, create your token (replace client_id, client_secret, username and password with the good values):

http POST http://v2.wallabag.org/oauth/v2/token \
    grant_type=password \
    client_id=12_5um6nz50ceg4088c0840wwc0kgg44g00kk84og044ggkscso0k \
    client_secret=3qd12zpeaxes8cwg8c0404g888co4wo8kc4gcw0occww8cgw4k \
    username=yourUsername \
    password=yourPassw0rd

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 http://v2.wallabag.org/api/entries.json \
    "Authorization:Bearer ZWFjNjA3ZWMwYWVmYzRkYTBlMmQ3NTllYmVhOGJiZDE0ZTg1NjE4MjczOTVlNzM0ZTRlMWQ0MmRlMmYwNTk5Mw"

This call will return all the entries for your user.

If you want to see all the API endpoints, you can have a look to our API documentation.

{% trans %}Back{% endtrans %}

{% endblock %}