Domotech site api

Action

Déclaration de cette API dans le fichier ApiAction.class.php. Voici un exemple d'objet action :

{"id":6,"moduleId":"1","description":"Piscine","action":"4","gpio":"0","value":"0","type":"1"}

Le champ action peut prendre les valeurs suivantes :

• 0 → pour un état (ON / OFF);
• 1 → pour un basculement (si ON → OFF / si OFF → ON);
• 2 → pour une basculement chronométrée;
• 3 → pour une modification PWM (eg. pour des leds);
• 4 → pour un capteur;

Le champ type peut prendre les caleurs suivantes :

• 0 → pour une lumière;
• 1 → pour une vanne;
• 2 → pour une porte;

Le champ gpio peut prendre les valeurs suivantes : D0,D1,D2,D3,D4,D5,D6,D7,D8; Le champ value peut prendre les valeurs suivantes :

• si le champs type est différent de 4 le champ est caduc;
• si le champs type est égale à 4 cela correspond à un type de capteur:
  • 0 → pour une température;
  • 1 → pour un état;
  • 2 → pour un bouton;

URL	Corps	Verbe	Action	Code retour	Implémentée
/api/action	vide	GET	Récupère la liste de toutes les actions	200
/api/action/$$ID$$	vide	GET	Récupère l'action qui à l'id $$ID$$	200 : si l'action existe 404 : si l'action n'existe pas
/api/action	module_id → l'id du module auquel rattacher l'action; description → la description de l'action; gpio → le numéro de broche; action → le type d'action (entre 0 et 4); type → le type d'objet commandé (entre 0 et 2); value → si le champs action est égale à	POST	Créer un objet action	200 : si tous les champs correspondent et que le module existe. La valeur retournée correspond à l'identifiant de la nouvelle action (eg. { id : '10' }) ; 400 : si un champ manque ou ne correspond pas;
/api/action/$$ID$$	vide	PUT	Exécute l'action désignée par $$ID$$	200 : si l'action existe; 400 : si l'action n'a pas aboutie; 404 : si l'action n'existe pas;
/api/action/$$ID$$	vide	DELETE	Efface l'action désignée par $$ID$$	200 : si l'action existe; 404 : si l'action n'existe pas;

Module

Déclaration de cette API dans le fichier ApiRemote.class.php. Voici un exemple d'objet remote : {"id":"R0","serial":"123456","description":"T\u00e9l bassin","nbButton":"6"}

URL	Corps	Verbe	Action	Code retour	Implémentée
/api/remote	vide	GET	Récupère la liste de toutes les télécommandes	200
/api/remote/$$ID$$	vide	GET	Récupère la télécommande qui à l'id $$ID$$	200 : si l'action existe 404 : si l'action n'existe pas
/api/remote	remoteId → l'id de la télécommande; description → la description de la télécommande; serial → le numéro de série de la télécommande (id unique); nbButton → le nombre de boutons de la télécommande;	POST	Créer un objet télécommande	200 : si tous les champs correspondent. La valeur retournée correspond à l'identifiant de la nouvelle action (eg. { id : 'R0' }) ; 400 : si un champ manque ou ne correspond pas;
/api/remote/$$ID$$	vide	DELETE	Efface la télécommande désignée par $$ID$$	200 : si la télécommande existe; 404 : si la télécommande n'existe pas;

Remote

TBD

Scenario

TBD

Logic

TBD

Schedule

TBD

Notification

TBD