Différences entre versions de « Spark-Could-API-ReadingData »
| (5 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= | + | {{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.