Différences entre versions de « Spark-Could-API-ReadingData »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(3 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Spark.IO-Could-API-NAV}}
 
{{Spark.IO-Could-API-NAV}}
 +
 +
{{traduction}}
  
 
== Introduction ==
 
== Introduction ==
Ligne 8 : Ligne 10 :
 
== Sur le Core - Variable ==
 
== Sur le Core - Variable ==
  
−
{{bloc-etroit|text=Imagine you have a temperature sensor attached to the A0 pin of your Spark Core and your firmware has exposed the value of the sensor as a Spark variable.}}
+
{{bloc-etroit|text=Imaginez un senseur de température branché sur la broche A0 de votre Spark Core et votre firmware exposant la valeur du senseur en tant que variable Spark.}}
  
 
  <nowiki>/* FIRMWARE */
 
  <nowiki>/* FIRMWARE */
Ligne 25 : Ligne 27 :
  
 
== Appel d'API ==
 
== Appel d'API ==
−
You can now make a '''GET''' request, even with your browser, to read the sensor at any time. The API endpoint is '''/v1/devices/{DEVICE_ID}/{VARIABLE}''' and as always, you have to include your access token.
+
Vous pouvez faire une requête '''GET''', même dans votre navigateur, pour lire le senseur à l'importe quel moment. Le point d'API est '''/v1/devices/{DEVICE_ID}/{VARIABLE}''' et comme toujours, vous devez inclure votre access_point.
  
−
  <nowiki># EXAMPLE REQUEST IN TERMINAL
+
  <nowiki># EXEMPLE DE REQUETE DANS UN TERMINAL
−
# Core ID is 0123456789abcdef01234567
+
# Core ID est 0123456789abcdef01234567
−
# Your access token is 1234123412341234123412341234123412341234
+
# Votre access_token est 1234123412341234123412341234123412341234
 
curl "https://api.spark.io/v1/devices/0123456789abcdef01234567/temperature?access_token=1234123412341234123412341234123412341234"</nowiki>
 
curl "https://api.spark.io/v1/devices/0123456789abcdef01234567/temperature?access_token=1234123412341234123412341234123412341234"</nowiki>
  
−
And the response contains a result like this:
+
Et la réponse contient un résultat comme celui-ci:
  
−
  <nowiki>// EXAMPLE RESPONSE
+
  <nowiki>// EXEMPLE DE REPONSE
 
{
 
{
 
   "cmd": "VarReturn",
 
   "cmd": "VarReturn",
Ligne 48 : Ligne 50 :
 
== Longueur des variables ==
 
== Longueur des variables ==
  
−
{{ambox|text=Variable names {{underline|are truncated after the 12th character}}.<br />temperature_sensor is accessible as temperature_ }}
+
{{ambox|text=Le nom des variables {{underline|sont tronqués après le 12ième caractère}}.<br />Une variable ''temperature_sensor'' sera exposée et accessible en tant que ''temperature_'' }}
  
 
{{Spark.IO-Could-API-TRAILER}}
 
{{Spark.IO-Could-API-TRAILER}}

Version actuelle datée du 11 janvier 2015 à 14:11


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.
Page-under-construction.pngPage(s) en cours de traduction/élaboration.

Page(s) under translation/construction

Introduction

Il est également possible de lire des données depuis votre core. Cela peut prendre deux formes différentes:

  • Lire une variable
  • Lecture d'événement (voir point suivant)

Sur le Core - Variable

Imaginez un senseur de température branché sur la broche A0 de votre Spark Core et votre firmware exposant la valeur du senseur en tant que variable Spark. 

/* FIRMWARE */
int temperature = 0;

void setup()
{
  Spark.variable("temperature", &temperature, INT);
  pinMode(A0, INPUT);
}

void loop()
{
  temperature = analogRead(A0);
}

Appel d'API

Vous pouvez faire une requête GET, même dans votre navigateur, pour lire le senseur à l'importe quel moment. Le point d'API est /v1/devices/{DEVICE_ID}/{VARIABLE} et comme toujours, vous devez inclure votre access_point. 

# EXEMPLE DE REQUETE DANS UN TERMINAL
# Core ID est 0123456789abcdef01234567
# Votre access_token est 1234123412341234123412341234123412341234
curl "https://api.spark.io/v1/devices/0123456789abcdef01234567/temperature?access_token=1234123412341234123412341234123412341234"

Et la réponse contient un résultat comme celui-ci: 

// EXEMPLE DE REPONSE
{
  "cmd": "VarReturn",
  "name": "temperature",
  "result": 42,
  "coreInfo": {
    "last_app": "",
    "last_heard": "2014-08-22T22:33:25.407Z",
    "connected": true,
    "deviceID": "53ff6c065075535119511687"
  }

Longueur des variables

 Le nom des variables sont tronqués après le 12ième caractère.
Une variable temperature_sensor sera exposée et accessible en tant que temperature_

Source: Cloud CODE (API) créé par Spark.IO.

Traduction réalisée par Meurisse D pour MCHobby.be - Translated by Meurisse D. for MCHobby.be

Traduit avec l'autorisation de Spark.IO - Translated with the permission from Spark.IO - Spark.IO

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Récupérée de « https://wiki.mchobby.be/index.php?title=Spark-Could-API-ReadingData&oldid=13524 »