29 922
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 43 :
Ligne 43 : − + − Example commands will always start with '''curl'''.+ + − To send a custom header using curl, use you the -H flag. The access token is called a "Bearer" token and goes in the standard HTTP Authorization header.+ + − The query string is the part of the URL after a ? question mark. To send the access token in the query string just add access_token=38bb.... Because your terminal thinks the question mark is special, we escape it with a backslash.+ + + + − The request body is how form contents are submitted on the web. Using curl, each parameter you send, including the access token is preceded by a -d flag. By default, if you add a -d flag, curl assumes that the request is a POST. If you need a different request type, you have to specifically say so with the -X flag, for example -X PUT.+ + +
→Comment envoyer votre access_token
* Dans l'entête d'autorisation HTTP (''HTTP Authorization header''). Fonctionne toujours.
* Dans l'entête d'autorisation HTTP (''HTTP Authorization header''). Fonctionne toujours.
* Inlus dans l'URL de la requête (dans la ''query string''). Fonctionne uniquement avec les requêtes GET.
* Inlus dans l'URL de la requête (dans la ''query string''). Fonctionne uniquement avec les requêtes GET.
* Dans le corps de la requête. Fonctionne uniquement avec POST et PUT lorsque l'URL est encodée dans le corps.
* Dans le corps de la requête. Fonctionne uniquement avec POST et PUT lorsque l'URL est encodée dans le corps (''content request'').
Dans ces documents, vous allez voir des exemples d'appel utilisant le programme CURL en ligne de commande. CURL est disponible sur toutes les plateformes.
Dans ces documents, vous allez voir des exemples d'appel utilisant le programme CURL en ligne de commande. CURL est disponible sur toutes les plateformes.
Les commandes d'exemples vont toujours commencer avec '''curl'''.
==== Dans l'entête HTTP ====
<nowiki>curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
<nowiki>curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
https://...</nowiki>
https://...</nowiki>
Utiliser le flag/drapeau pour envoyer une entête personnalisée en utilisant CURL. Le token d'accès est appelé un jeton "Bearer" et prends place dans l'entête d'autorisation HTTP standard (''standard HTTP Authorization header'').
==== Dans la Query String ====
<nowiki>curl https://api.spark.io/v1/devices\?access_token=38bb7b318cc6898c80317decb34525844bc9db55</nowiki>
<nowiki>curl https://api.spark.io/v1/devices\?access_token=38bb7b318cc6898c80317decb34525844bc9db55</nowiki>
La ''query string'' est la partie de l'URL après le point d'interrogation (?). Pour envoyer un access token dans la "query string" ajoutez simplement access_token=38bb....
Note: étant donné que le terminal va interpréter le ? comme un caractère spécial de remplacement, nous devons utiliser la séquence d'échappement (\?).
==== Dans le corps de requête ====
<nowiki>curl -d access_token=38bb7b318cc6898c80317decb34525844bc9db55
<nowiki>curl -d access_token=38bb7b318cc6898c80317decb34525844bc9db55
https://...</nowiki>
https://...</nowiki>
Le corps de requête (''content request'') est la façon dont un formulaire est soumis sur le Web (élément html '''FORM'''). En utilisant curl, chaque paramètre que vous voulez envoyer (incluant l'access token) doit être précédé du flag/drapeau -d.
By default, if you add a -d flag, curl assumes that the request is a POST. If you need a different request type, you have to specifically say so with the -X flag, for example -X PUT.
=== Générer un nouvel access_token ===
=== Générer un nouvel access_token ===