29 918
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − − {{traduction}} Ligne 68 :
Ligne 66 : − 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.+ − When creating a new access token, you need to specify several additional pieces of info.+ − You must give a valid client ID and password in HTTP Basic Auth. Any client ID will work right now, so we suggest '''spark:spark''' (''utilisateur:mot_de_passe''). In the POST body, you need three parameters:+ − + − + − + − + − + Ligne 91 :
Ligne 89 : − For now, Spark Build will list the single most recently created token.+ + + + + + + + + + + + + + + − You can list all your access tokens by passing your email address and password in an HTTP Basic Auth header to '''/v1/access_tokens'''.+ − + − + Ligne 114 :
Ligne 126 : + + + + + + − If you have a bunch of unused tokens and want to clean up, you can delete tokens.+ − Just as for listing them, send your username and password in an HTTP Basic Auth header.+ − + − + + + +
→Effacer un access_token
{{Spark.IO-Could-API-NAV}}
{{Spark.IO-Could-API-NAV}}
== Authentification ==
== Authentification ==
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.
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.
Par défaut, si vous ajoutez un flag/drapeau -d alors CURL considère que vous voulez faire une requête de type POST. Si vous avez besoin d'indiquer un type de requête différent alors vous pouvez utiliser le flag/drapeau -X (ex: -X PUT).
=== Générer un nouvel access_token ===
=== Générer un nouvel access_token ===
Lorsque vous créez un nouvel access token, vous devez spécifier plusieurs informations complémentaires.
POST /oauth/token
POST /oauth/token
Vous devez fournir un ''client ID'' et un mot de passe valide dans l'entête d’authentification HTTP (HTTP Basic Auth). N'importe quel ''Client ID'' fonctionnera pour le moment, Spark suggère d'utiliser '''spark:spark''' (''utilisateur:mot_de_passe''). Dans le corps de la requête, vous aurez besoin de trois paramètres:
* grant_type=password
* grant_type=password
* username=YOUR_EMAIL@ADDRE.SS
* username=VOTRE_EMAIL@ADRES.SE
* password=YOUR_PASSWORD
* password=VOTRE_MOT_DE_PASSE
<nowiki># Using curl in your terminal
<nowiki># En utilisant Curl en ligne de commande
curl https://api.spark.io/oauth/token -u spark:spark \
curl https://api.spark.io/oauth/token -u spark:spark \
-d grant_type=password -d username=joe@example.com -d password=SuperSecret
-d grant_type=password -d username=joe@example.com -d password=SuperSecret
# A typical JSON response will look like this
# Exemple typique de réponse JSON:
{
{
"access_token": "254406f79c1999af65a7df4388971354f85cfee9",
"access_token": "254406f79c1999af65a7df4388971354f85cfee9",
"expires_in": 7776000
"expires_in": 7776000
}</nowiki>
}</nowiki>
A partir de maintenant, Spark Build affichera le dernier token créé (le plus récent).
{{underline|'''Note #1 de MCHobby:'''}}
Le mot "Bearer" signifie ''titulaire''. L'access_token généré permet d'accéder en tant que titulaire.
{{underline|'''Note #2 de MCHobby:'''}}
Admettons que nous utilisons l'appel suivant:
<nowiki>curl https://api.spark.io/oauth/token -u xyz:xyz \
-d grant_type=password -d username=votre_adresse@email.com -d password=votre_mot_de_passe_Spark</nowiki>
Lorsque vous listerez vos cores (voir ci-dessous), vous verrez apparaitre "client: xyz" comme identification du client!
Si vous exécutez plusieurs fois la commande curl, vous obtiendrez plusieurs access_token différent MAIS TOUS VALIDES. Ils apparaitrons tous dans la liste des access_token.
=== Lister tous vos tokens ===
=== Lister tous vos tokens ===
Vous pouvez lister tous vos ''access token'' en passant votre adresse e-mail et mot de passe dans l'entête Auth de la requête. Requête adressée à '''/v1/access_tokens'''.
GET /v1/access_tokens
GET /v1/access_tokens
<nowiki># Using curl in your terminal
<nowiki># En utilisant curl en ligne de commande
curl https://api.spark.io/v1/access_tokens -u joe@example.com:SuperSecret
curl https://api.spark.io/v1/access_tokens -u joe@example.com:SuperSecret
# Example JSON response
# Exemple de réponse JSON
[
[
{
{
}
}
]</nowiki>
]</nowiki>
{{underline|'''Note de MCHobby:'''}}
* Lorsque nous avons cherché l'access_token visible dans Spark Build, nous avons noté que celui-ci correspondait au token "client: user".
* Si vous utilisez Spark-CLI, ce dernier obtiendra également son propre access_token correspondant à "client: spark-cli"
* Spark IDE semble également avoir son propre access_token correspondant à "client: spark-ide"
=== Effacer un access_token ===
=== Effacer un access_token ===
Si vous avez des access token inutilisé et que vous voulez les nettoyer, vous pouvez effacer ces tokens.
DELETE /v1/access_tokens/:token
DELETE /v1/access_tokens/:token
Comme pour lister les access_tokens, vous devez envoyer votre nom d'utilisateur et mot de passe dans l'entête d'authentification de la requête.
<nowiki># Using curl in your terminal
<nowiki># En utilisant curl en ligne de commande
curl https://api.spark.io/v1/access_tokens/b5b901e8760164e134199bc2c3dd1d228acf2d98 \
curl https://api.spark.io/v1/access_tokens/b5b901e8760164e134199bc2c3dd1d228acf2d98 \
-u joe@example.com:SuperSecret -X DELETE
-u joe@example.com:SuperSecret -X DELETE
# Example JSON response
# Exemple de réponse JSON
{
{
"ok": true
"ok": true
}</nowiki>
}</nowiki>
{{underline|'''Note de MCHobby:'''}}
Durant l'écriture de [https://github.com/mchobby/SparkCoreTuto/tree/master/PyCall nos exemples] PyCall (Python Call pour Spark Core), nous avons noté qu'il était impossible d'effacer le dernier access_token crée (du moins via Python et urllib2).
{{Spark.IO-Could-API-TRAILER}}
{{Spark.IO-Could-API-TRAILER}}