Différences entre les versions de « Domotech site api »

De mydil
Aller à la navigation Aller à la recherche
Ligne 101 : Ligne 101 :
 
[[Fichier:implemented_green_tick.png|center|40px]]
 
[[Fichier:implemented_green_tick.png|center|40px]]
 
|}
 
|}
 +
 
= Module =
 
= Module =
 
TBD
 
TBD

Version du 5 novembre 2018 à 18:02

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
Implemented green tick.png

/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
Implemented green tick.png

/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;
Implemented green tick.png

/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;
Implemented green tick.png

/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;
Implemented green tick.png

Module

TBD

Remote

TBD

Scenario

TBD

Logic

TBD

Schedule

TBD

Notification

TBD