]> git.immae.eu Git - github/wallabag/wallabag.git/commitdiff
Update API documentation with cURL examples 1962/head
authorNicolas Lœuillet <nicolas@loeuillet.org>
Thu, 21 Apr 2016 16:48:17 +0000 (18:48 +0200)
committerNicolas Lœuillet <nicolas@loeuillet.org>
Thu, 21 Apr 2016 16:48:17 +0000 (18:48 +0200)
docs/en/developer/api.rst
docs/fr/developer/api.rst

index 38f0377c35e835c5d225350e2e21bcce02383e53..61182dcde2338b316ff057190aa1d1a32f8b8ed8 100644 (file)
@@ -69,7 +69,7 @@ You'll have this in return:
 
 We'll work with the ``access_token`` value in our next calls.
 
-Curl example:
+cURL example:
 
 ::
 
@@ -126,7 +126,7 @@ returns:
 
 The ``items`` array is empty.
 
-Curl example:
+cURL example:
 
 ::
 
@@ -186,7 +186,7 @@ returns
 
 Now, if you execute the previous command (see **Get existing entries**), you'll have data.
 
-Curl example:
+cURL example:
 
 ::
 
@@ -245,7 +245,7 @@ returns
 
 And if you want to list the existing entries (see **Get existing entries**), the array is empty.
 
-Curl example:
+cURL example:
 
 ::
 
index 9c8e25a9cd7424fb79050566e1ece6643243b664..28ddf105a29ee05a3fea253a581091499d5728a1 100644 (file)
@@ -7,7 +7,7 @@ Pré-requis
 ----------
 
 * wallabag fraichement installé et disponible à http://localhost:8000
-* ``httpie`` installé sur votre ordinateur (`voir le site du projet <https://github.com/jkbrzt/httpie>`__). Vous pouvez également adapter les commandes en utilisant curl ou wget. 
+* ``httpie`` installé sur votre ordinateur (`voir le site du projet <https://github.com/jkbrzt/httpie>`__). Vous pouvez également adapter les commandes en utilisant curl ou wget.
 * toutes les méthodes de l'API documentées ici http://localhost:8000/api/doc
 
 Créer un nouveau client d'API
@@ -69,6 +69,12 @@ Vous obtiendrez :
 
 Nous allons utiliser la valeur de ``access_token`` dans nos prochains appels.
 
+Exemple cURL :
+
+::
+
+    curl -s "https://localhost:8000/oauth/v2/token?grant_type=password&client_id=1_3o53gl30vhgk0c8ks4cocww08o84448osgo40wgw4gwkoo8skc&client_secret=636ocbqo978ckw0gsw4gcwwocg8044sco0w8w84cws48ggogs4&username=wallabag&password=wallabag"
+
 Récupérer les articles existants
 --------------------------------
 
@@ -120,6 +126,12 @@ retournera :
 
 Le tableau ``items`` est vide.
 
+Exemple cURL :
+
+::
+
+    curl --get "https://localhost:8000/api/entries.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
+
 Créer votre premier article
 ---------------------------
 
@@ -174,6 +186,12 @@ retournera :
 
 Maintenant, si vous exécutez la précédente commande (voir **Récupérer les articles existants**), vous obtiendrez quelque chose.
 
+Exemple cURL :
+
+::
+
+    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"
+
 Supprimer un article
 --------------------
 
@@ -227,6 +245,12 @@ retournera :
 
 Et si vous voulez voir la liste des articles existants (voir **Récupérer les articles existants**), le tableau sera vide.
 
+Exemple cURL :
+
+::
+
+    curl --request DELETE "https://localhost:8000/api/entries/1.html?access_token=ZGJmNTA2MDdmYTdmNWFiZjcxOWY3MWYyYzkyZDdlNWIzOTU4NWY3NTU1MDFjOTdhMTk2MGI3YjY1ZmI2NzM5MA"
+
 Autres méthodes
 ---------------