Projet API REST Generaliste publique

Bla bla sur la domotique. La section ou on se trompe jamais !

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 03 Juil 2014, 21:01

olebrun a écrit:ahah, en fait non tu peux laisser une réponse directe, quoi je suis chiant ? comprends pas :)


mouarf :mrgreen:

Nan mais la question se pose réellement car je me la suis posée longuement.
Faut-il à une réponse simple (1 seul élement (oui/non/valeur)) retourner une donnée brute ou l'encapsuler dans un json ?
Dans le premier cas, cela oblige l'utilisateur à le parser (et tout le monde ne maitrise pas forcément un traitement de json) mais on reste "API Compliant" ou dans le deuxième, c'est tout bête, la valeur retournée est la réponse, point barre.
Alors oui le débat est ouvert. Quelle est la meilleure réponse ? :)
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

Re: Projet API REST Generaliste publique

Messagede Calcipher » 03 Juil 2014, 22:25

Guiguiabloc a écrit:Nan mais la question se pose réellement car je me la suis posée longuement.
Faut-il à une réponse simple (1 seul élement (oui/non/valeur)) retourner une donnée brute ou l'encapsuler dans un json ?
Dans le premier cas, cela oblige l'utilisateur à le parser (et tout le monde ne maitrise pas forcément un traitement de json) mais on reste "API Compliant" ou dans le deuxième, c'est tout bête, la valeur retournée est la réponse, point barre.
Alors oui le débat est ouvert. Quelle est la meilleure réponse ? :)


Alors à mon avis, l'api pourrait s'enrichir pour donner d'un seul coup plusieurs infos sur le jour actuel (vacances scolaires en plus de férié par exemple), donc il vaut mieux rester sur un tableau json.
Sinon sur le contenu de la réponse, plutôt que yes/no j'aurais mis true/false car c'est un booléen (mais je chipote...).
Calcipher
Dieu de domotique
 
Messages: 255
Inscription: 14 Nov 2012, 09:58
Localisation: Angers

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 04 Juil 2014, 22:17

Calcipher a écrit:Alors à mon avis, l'api pourrait s'enrichir pour donner d'un seul coup plusieurs infos sur le jour actuel (vacances scolaires en plus de férié par exemple), donc il vaut mieux rester sur un tableau json.
Sinon sur le contenu de la réponse, plutôt que yes/no j'aurais mis true/false car c'est un booléen (mais je chipote...).


Alors j'ai simplifié le tout pour les réponses à 1 seul élément. Par défaut la réponse est en format raw (brut)
en spécifiant /json la fin de la requête, la réponse est restituée en json

(et j'ai remplacé no par False :wink: )

http://api.domogeek.fr/static/doc/index.html
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest


Re: Projet API REST Generaliste publique

Messagede giejo » 09 Juil 2014, 14:16

Punaise ! c'est une vrai bonne idée !
moi qui me tapait le calendrier google pour les jours fériés etc
Bravo Guigui

Une idée, je ne sais pas si elle est valable, j'utilise aussi l'alerte meteo qui a ete developpé je ne sais plus par qui ici... (désolé) est ce que ce ne serait pas intéressant d'agréger aussi ce type de developpement au sein de cette api ??
giejo
P'tit Guru de domotique
 
Messages: 71
Inscription: 10 Jan 2008, 15:42

Re: Projet API REST Generaliste publique

Messagede Calcipher » 09 Juil 2014, 15:55

Bonjour,

Avant de passer à la météo ou autres, je pense qu'il faut finir avec les types de jours.
Après les jours fériés et les jours de vacances, il faudrait obtenir :
- Les jours ouvrés (ni samedi, ni dimanche, ni férié)
- Les jours d'école (jour ouvré en dehors des vacances)

L'idéal serait d'avoir les 4 types(férié, vacances, ouvré et école) dans un même json pour une date donnée.

Cdt,
Calcipher
Dieu de domotique
 
Messages: 255
Inscription: 14 Nov 2012, 09:58
Localisation: Angers

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 09 Juil 2014, 20:12

giejo a écrit:Punaise ! c'est une vrai bonne idée !
moi qui me tapait le calendrier google pour les jours fériés etc
Bravo Guigui

Une idée, je ne sais pas si elle est valable, j'utilise aussi l'alerte meteo qui a ete developpé je ne sais plus par qui ici... (désolé) est ce que ce ne serait pas intéressant d'agréger aussi ce type de developpement au sein de cette api ??


Merci giejo :) Ca me fait vraiment plaisir :)

La météo est dans ma TODO list ;)
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 09 Juil 2014, 20:14

Calcipher a Ă©crit:Bonjour,

Avant de passer à la météo ou autres, je pense qu'il faut finir avec les types de jours.
Après les jours fériés et les jours de vacances, il faudrait obtenir :
- Les jours ouvrés (ni samedi, ni dimanche, ni férié)
- Les jours d'école (jour ouvré en dehors des vacances)

L'idéal serait d'avoir les 4 types(férié, vacances, ouvré et école) dans un même json pour une date donnée.

Cdt,


Allez, un premier lot de livraison avant de regrouper tout cela :)

[UPDATE]

Ajout Week-end

Savoir si aujourd'hui, demain ou tel jour est un week-end :

curl http://api.domogeek.fr/weekend/now
curl http://api.domogeek.fr/weekend/tomorrow
curl http://api.domogeek.fr/weekend/28-06-2014

Retourne "True" si c'est pendant le week-end, "False" sinon. (ajouter /json pour un retour en json)

http://api.domogeek.fr/static/doc/index ... GetWeekend
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 09 Juil 2014, 21:22

Calcipher a écrit:L'idéal serait d'avoir les 4 types(férié, vacances, ouvré et école) dans un même json pour une date donnée.


[UPDATE]

Ajout de la fonction holidayall (retourne un json sur la date (maintenant ou une date spécifiée) contenant férié, week-end et vacances scolaires (zone à spécifier)

curl http://api.domogeek.fr/holidayall/A/now

{"holiday": "False", "weekend": "False", "schoolholiday": "Vacances d'été"}

curl http://api.domogeek.fr/holidayall/A/25-02-2014

{"holiday": "False", "weekend": "False", "schoolholiday": "False"}

http://api.domogeek.fr/static/doc/index ... Holidayall

(et 3 suffisent, si 3 = False alors forcément ecole = True :p)
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

Re: Projet API REST Generaliste publique

Messagede Calcipher » 10 Juil 2014, 12:38

Guiguiabloc a écrit:Ajout de la fonction holidayall (retourne un json sur la date (maintenant ou une date spécifiée) contenant férié, week-end et vacances scolaires (zone à spécifier)

C'est cool ça, y'a qu'a demander...
Bravo et merci pour le boulot et la réactivité.
Calcipher
Dieu de domotique
 
Messages: 255
Inscription: 14 Nov 2012, 09:58
Localisation: Angers

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 10 Juil 2014, 19:49

Calcipher a Ă©crit:
Guiguiabloc a écrit:Ajout de la fonction holidayall (retourne un json sur la date (maintenant ou une date spécifiée) contenant férié, week-end et vacances scolaires (zone à spécifier)

C'est cool ça, y'a qu'a demander...
Bravo et merci pour le boulot et la réactivité.


avec plaisir :mrgreen:
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

Re: Projet API REST Generaliste publique

Messagede Guiguiabloc » 10 Juil 2014, 19:51

giejo a écrit:Une idée, je ne sais pas si elle est valable, j'utilise aussi l'alerte meteo qui a ete developpé je ne sais plus par qui ici... (désolé) est ce que ce ne serait pas intéressant d'agréger aussi ce type de developpement au sein de cette api ??


Je pense que tu parles du fichier xml de @fabmaurel http://www.planete-domotique.com/blog/2014/01/03/la-vigilance-meteo-dans-votre-box-domotique-evolue/comment-page-1/

Je viens de lui demander l'autorisation d'utiliser son fichier pour l'api, j'attends sa réponse :wink:
Avatar de l’utilisateur
Guiguiabloc
Dieu de domotique
 
Messages: 449
Inscription: 21 Jan 2011, 22:56
Localisation: Brest

PrécédenteSuivante

Retourner vers Discussions Générales

Qui est en ligne

Utilisateurs parcourant ce forum: Aucun utilisateur enregistré et 5 invités

Copyright © 2011 - Touteladomotique.com - Tous droits rĂ©servĂ©s
Les blogs partenaires : Abavala, Domo-Blog, Domotique34, Maison et Domotique