--- title: Methods weight: 2 --- ## Getting existing entries Documentation for this method: https://app.wallabag.it/api/doc#get--api-entries.{_format} As we work on a fresh wallabag installation, we'll have no result with this command: ```bash http GET http://localhost:8000/api/entries.json \ "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" ``` returns: ```http HTTP/1.1 200 OK 0: application/json Cache-Control: no-cache Connection: close Content-Type: application/json Date: Tue, 05 Apr 2016 08:51:32 GMT Host: localhost:8000 Set-Cookie: PHPSESSID=nrogm748md610ovhu6j70c3q63; path=/; HttpOnly X-Debug-Token: 4fbbc4 X-Debug-Token-Link: /_profiler/4fbbc4 X-Powered-By: PHP/7.0.4 { "_embedded": { "items": [] }, "_links": { "first": { "href": "http://localhost:8000/api/entries?page=1&perPage=30" }, "last": { "href": "http://localhost:8000/api/entries?page=1&perPage=30" }, "self": { "href": "http://localhost:8000/api/entries?page=1&perPage=30" } }, "limit": 30, "page": 1, "pages": 1, "total": 0 } ``` The `items` array is empty. cURL example: ```bash curl --get "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" ``` ## Adding your first entry Documentation for this method: https://app.wallabag.it/api/doc#post--api-entries.{_format} ```bash http POST http://localhost:8000/api/entries.json \ "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" \ url="http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" ``` returns ```http HTTP/1.1 200 OK 0: application/json Cache-Control: no-cache Connection: close Content-Type: application/json Date: Tue, 05 Apr 2016 09:07:54 GMT Host: localhost:8000 Set-Cookie: PHPSESSID=bjie40ck72kp2pst3i71gf43a4; path=/; HttpOnly X-Debug-Token: e01c51 X-Debug-Token-Link: /_profiler/e01c51 X-Powered-By: PHP/7.0.4 { "_links": { "self": { "href": "/api/entries/1" } }, "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en  charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n

Lire

\n \n \n \n \"Firefox
\n

Firefox prépare l'enterrement des vieux plugins

\n
\n
\n
\n
\n

Lire

\n \n \n \n \"Comment
\n

Comment activer la navigation privée sur son navigateur web

\n
\n
\n
\n
\n

Lire

\n \n \n \n \"Firefox
\n

Firefox se mettra à jour un peu moins régulièrement

\n
\n
\n
\n", "created_at": "2016-04-05T09:07:54+0000", "domain_name": "www.numerama.com", "id": 1, "is_archived": 0, "is_starred": 0, "language": "fr-FR", "mimetype": "text/html", "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", "reading_time": 2, "tags": [], "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", "updated_at": "2016-04-05T09:07:54+0000", "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", "user_email": "", "user_id": 1, "user_name": "wallabag" } ``` Now, if you execute the previous command (see **Get existing entries**), you'll have data. cURL example: ```bash curl "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA&url=http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html" ``` ## Deleting an entry Documentation for this method: https://app.wallabag.it/api/doc#delete--api-entries-{entry}.{_format} ```bash http DELETE http://localhost:8000/api/entries/1.json \ "Authorization:Bearer ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" ``` returns ```http HTTP/1.1 200 OK 0: application/json Cache-Control: no-cache Connection: close Content-Type: application/json Date: Tue, 05 Apr 2016 09:19:07 GMT Host: localhost:8000 Set-Cookie: PHPSESSID=jopgnfvmuc9a62b27sqm6iulr6; path=/; HttpOnly X-Debug-Token: 887cef X-Debug-Token-Link: /_profiler/887cef X-Powered-By: PHP/7.0.4 { "_links": { "self": { "href": "/api/entries/" } }, "annotations": [], "content": "

Fonctionnant sur le même principe que Pocket, Instapaper ou Readability, le logiciel Wallabag permet de mémoriser des articles pour les lire plus tard. Sa nouvelle version apporte une multitude de nouvelles fonctionnalités.

Si vous utilisez Firefox comme navigateur web, vous avez peut-être constaté l’arrivée d’une fonctionnalité intitulée Pocket. Disponible autrefois sous la forme d’un module complémentaire, et sous un autre nom (Read it Later), elle est depuis le mois de juin 2015 directement incluse au sein de Firefox.

\n

Concrètement, Pocket sert à garder en mémoire des contenus que vous croisez au fil de la navigation, comme des articles de presse ou des vidéos, afin de pouvoir les consulter plus tard. Pocket fonctionne un peu comme un système de favoris, mais en bien plus élaboré grâce à ses options supplémentaires.

\n

Mais Pocket fait polémique, car il s’agit d’un projet propriétaire qui est intégré dans un logiciel libre. C’est pour cette raison que des utilisateurs ont choisi de se tourner vers d’autres solutions, comme Wallabag, qui est l’équivalent libre de Pocket et d’autres systèmes du même genre, comme Instapaper et Readability.

\n

Et justement, Wallabag évolue. C’est ce dimanche que la version 2.0.0 du logiciel a été publiée par l’équipe en  charge de son développement et celle-ci contient de nombreux changements par rapport aux moutures précédentes (la documentation est traduite en français), lui permettant d’apparaître comme une alternative à Pocket, Instapaper et Readability.

\n

\"homepage\"

\n

Parmi les principaux changements que l’on peut retenir avec cette nouvelle version, notons la possibilité d’écrire des annotations dans les articles mémorisés, de filtrer les contenus selon divers critères (temps de lecture, nom de domaine, date de création, statut…), d’assigner des mots-clés aux entrées, de modifier le titre des articles, le support des flux RSS ou encore le support de plusieurs langues dont le français.

\n

D’autres options sont également à signaler, comme l’aperçu d’un article mémorisé (si l’option est disponible), un guide de démarrage rapide pour les débutants, un outil d’export dans divers formats (PDF, JSON, EPUB, MOBI, XML, CSV et TXT) et, surtout, la possibilité de migrer vers Wallabag depuis Pocket, afin de convaincre les usagers de se lancer.

\n \n \n

Articles liés

\n
\n
\n

Lire

\n \n \n \n \"Firefox
\n

Firefox prépare l'enterrement des vieux plugins

\n
\n
\n
\n
\n

Lire

\n \n \n \n \"Comment
\n

Comment activer la navigation privée sur son navigateur web

\n
\n
\n
\n
\n

Lire

\n \n \n \n \"Firefox
\n

Firefox se mettra à jour un peu moins régulièrement

\n
\n
\n
\n", "created_at": "2016-04-05T09:07:54+0000", "domain_name": "www.numerama.com", "is_archived": 0, "is_starred": 0, "language": "fr-FR", "mimetype": "text/html", "preview_picture": "http://www.numerama.com/content/uploads/2016/04/post-it.jpg", "reading_time": 2, "tags": [], "title": "Le Pocket libre Wallabag fait le plein de fonctionnalités - Tech - Numerama", "updated_at": "2016-04-05T09:07:54+0000", "url": "http://www.numerama.com/tech/160115-le-pocket-libre-wallabag-fait-le-plein-de-fonctionnalites.html", "user_email": "", "user_id": 1, "user_name": "wallabag" } ``` And if you want to list the existing entries (see **Get existing entries**), the array is empty. cURL example: ```bash curl --request DELETE "https://localhost:8000/api/entries/1.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA" ``` ## Other methods We didn't write examples for each API method. Have a look on the listing here: https://app.wallabag.it/api/doc to learn about each method.