Différences entre versions de « Spark-Could-API-ReadingData »
(Page créée avec « {{Spark.IO-Could-API-NAV}} == Introduction == {{bloc-etroit|text=Il est également possible de lire des données depuis votre core. Cela peut prendre deux formes différente... ») |
|||
(6 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 6 : | Ligne 8 : | ||
* Lecture d'événement (voir point suivant)}} | * Lecture d'événement (voir point suivant)}} | ||
− | == Variable == | + | == Sur le Core - Variable == |
− | {{bloc-etroit|text= | + | {{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 == | ||
− | + | 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># 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"</nowiki> | ||
+ | |||
+ | Et la réponse contient un résultat comme celui-ci: | ||
+ | |||
+ | <nowiki>// EXEMPLE DE REPONSE | ||
+ | { | ||
+ | "cmd": "VarReturn", | ||
+ | "name": "temperature", | ||
+ | "result": 42, | ||
+ | "coreInfo": { | ||
+ | "last_app": "", | ||
+ | "last_heard": "2014-08-22T22:33:25.407Z", | ||
+ | "connected": true, | ||
+ | "deviceID": "53ff6c065075535119511687" | ||
+ | }</nowiki> | ||
+ | |||
+ | == Longueur des variables == | ||
+ | |||
+ | {{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
En cours de traduction/élaboration. |
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.