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

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
Ligne 19 : Ligne 19 :
 
* https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events
 
* https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events
 
* http://www.html5rocks.com/en/tutorials/eventsource/basics/
 
* http://www.html5rocks.com/en/tutorials/eventsource/basics/
−
 
−
{{traduction}}
 
  
 
Souscrire au flux des évènements publiques, plus les évènements privés publiés par vos Cores:
 
Souscrire au flux des évènements publiques, plus les évènements privés publiés par vos Cores:
Ligne 32 : Ligne 30 :
 
Souscrire à tous les évènement, publiques et privés, publiés par vos Cores:
 
Souscrire à tous les évènement, publiques et privés, publiés par vos Cores:
  
−
GET /v1/devices/events[/:event_name]
+
GET /v1/devices/events[/:nom_evenement]
  
−
  <nowiki># EXAMPLE
+
  <nowiki># EXEMPLE
 
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
 
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
 
https://api.spark.io/v1/devices/events/temperature</nowiki>
 
https://api.spark.io/v1/devices/events/temperature</nowiki>
  
−
Subscribe to events from one specific device. If the API user owns the device, then she will receive all events, public and private, published by that device. If the API user does not own the device she will only receive public events.
+
Souscrire aux événements d'un Core Spécifique. Si l'utilisateur de l'API possède le Core alors il recevra tous les évènements, publiques et privés, publié par le Core. Si l'utilisateur de l'API ne possède pas le Core il recevra uniquement les événements publiques.
  
−
  <nowiki>GET /v1/devices/:device_id/events[/:event_name]
+
  <nowiki>GET /v1/devices/:core_id/events[/:nom_evenement]
  
−
# EXAMPLE
+
# EXEMPLE
 
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
 
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
 
https://api.spark.io/v1/devices/55ff70064939494339432586/events/temperature</nowiki>
 
https://api.spark.io/v1/devices/55ff70064939494339432586/events/temperature</nowiki>
  
 
{{Spark.IO-Could-API-TRAILER}}
 
{{Spark.IO-Could-API-TRAILER}}

Version du 16 janvier 2015 à 15:44


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.
En cours de traduction/élaboration.

Enregistrer un CallBack

Dans la section build du site web de Spark, vous serez capable d'enregistrer une URL vers votre propre serveur... une URL vers laquelle Spark effectuera un POST à chaque fois que votre Spark Cores publiera certain événement.

Cette fonctionnalité est toujours en cours de développement et devrait être disponible courant Mars.

Souscrire un événement

Vous pouvez faire un appel d'API qui ouvre un flux (stream) de type Server-Sent Events (SSEs). Vous ferez un appel d'API qui ouvre une connexion vers Spark Cloud. Au contraire d'un appel HTTP normal qui ferme la connexion le plus rapidement possible, cette connexion SSE restera ouverte. Très peu d'information sera envoyé par cette connexion à moins que votre Spark Core ne publie un événement, auquel cas vous serez immédiatement notifié.

Pour souscrire (subscribe) à un flux (stream) d'événement, faite une requête GET sur un des points de contact suivant (endpoint). Cela ouvre un flux Server-Sent Events (SSE), par exemple, un socket TCP qui peu rester ouvert. Dans tous les cas, le nom de l'événement à filtrer (dans l'URI) est optionnel. Lorsque vous spécifiez un filtre "nom d'événement", les événements publiés seront limités à ceux commençant par la chaine de caractère (celle spécifiée comme filtre). Par exemple, si vous spécifiez 'temp' comme filtre, vous recevrez les événements ayant avec les noms 'temp' et 'temperature'.

Ressources SSE:

Souscrire au flux des évènements publiques, plus les évènements privés publiés par vos Cores: 

GET /v1/events[/:nom_evenement]

# EXEMPLE
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
https://api.spark.io/v1/events/temperature

Souscrire à tous les évènement, publiques et privés, publiés par vos Cores:

GET /v1/devices/events[/:nom_evenement] 

# EXEMPLE
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
https://api.spark.io/v1/devices/events/temperature

Souscrire aux événements d'un Core Spécifique. Si l'utilisateur de l'API possède le Core alors il recevra tous les évènements, publiques et privés, publié par le Core. Si l'utilisateur de l'API ne possède pas le Core il recevra uniquement les événements publiques. 

GET /v1/devices/:core_id/events[/:nom_evenement]

# EXEMPLE
curl -H "Authorization: Bearer 38bb7b318cc6898c80317decb34525844bc9db55"
https://api.spark.io/v1/devices/55ff70064939494339432586/events/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-Events&oldid=13542 »