Différences entre versions de « Spark-Could-API-ReadingData »
Ligne 26 : | Ligne 26 : | ||
== 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. | 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. | ||
+ | |||
+ | <nowiki># EXAMPLE REQUEST IN TERMINAL | ||
+ | # Core ID is 0123456789abcdef01234567 | ||
+ | # Your access token is 1234123412341234123412341234123412341234 | ||
+ | curl "https://api.spark.io/v1/devices/0123456789abcdef01234567/temperature?access_token=1234123412341234123412341234123412341234"</nowiki> | ||
+ | |||
+ | And the response contains a result like this: | ||
+ | |||
+ | <nowiki>// EXAMPLE RESPONSE | ||
+ | { | ||
+ | "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 == | ||
+ | |||
+ | Variable names {{underline|are truncated after the 12th character}}: temperature_sensor is accessible as temperature_ | ||
{{Spark.IO-Could-API-TRAILER}} | {{Spark.IO-Could-API-TRAILER}} |
Version du 7 janvier 2015 à 07:39
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
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.
/* FIRMWARE */ int temperature = 0; void setup() { Spark.variable("temperature", &temperature, INT); pinMode(A0, INPUT); } void loop() { temperature = analogRead(A0); }
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.
# EXAMPLE REQUEST IN TERMINAL # Core ID is 0123456789abcdef01234567 # Your access token is 1234123412341234123412341234123412341234 curl "https://api.spark.io/v1/devices/0123456789abcdef01234567/temperature?access_token=1234123412341234123412341234123412341234"
And the response contains a result like this:
// EXAMPLE RESPONSE { "cmd": "VarReturn", "name": "temperature", "result": 42, "coreInfo": { "last_app": "", "last_heard": "2014-08-22T22:33:25.407Z", "connected": true, "deviceID": "53ff6c065075535119511687" }
Longueur des variables
Variable names are truncated after the 12th character: temperature_sensor is accessible as 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.