{"id":6339,"date":"2018-10-03T13:08:46","date_gmt":"2018-10-03T11:08:46","guid":{"rendered":"https:\/\/www.iggo.fr\/docs\/api\/sondes\/recueillir-les-donnees-de-vos-sondes\/"},"modified":"2019-07-01T20:56:33","modified_gmt":"2019-07-01T18:56:33","slug":"acquerir-donnees-mods","status":"publish","type":"docs","link":"https:\/\/www.iggo.fr\/docs\/api\/sondes\/acquerir-donnees-mods\/","title":{"rendered":"Acqu\u00e9rir les donn\u00e9es de vos mod’s"},"content":{"rendered":"

Votre compte vous donne un acc\u00e8s imm\u00e9diat \u00e0 notre API gratuite : elle vous permet d’int\u00e9grer facilement nos services \u00e0 vos site web, logiciel ou application CRM en PHP<\/code>, ASP<\/code>, .NET<\/code>, JAVA<\/code> ou tout autre langage.<\/p>\n

\n
\n

URL<\/h2>\n

\n\n\tPOST<\/span> https:\/\/api.production.iggo.fr\/api\/v1\/<\/h4>\n

\n\n\tGET<\/span> https:\/\/api.production.iggo.fr\/api\/v1\/<\/h4>\n<\/div>\n
\n

Param\u00e8tres<\/h2>\n

Chaque demande d’API prend en charge les param\u00e8tres suivants :<\/p>\n<\/div>\n

\n

Informations techniques<\/h2>\n\n\n\n\n\n\n\n
#<\/th>\nSignification<\/th>\n<\/tr>\n<\/thead>\n
HTTP Method<\/th>\nToutes les requ\u00eates peuvent \u00eatre soumises en POST.<\/td>\n<\/tr>\n
Encodage<\/th>\nNotre API fonctionne en UTF8. Pensez \u00e0 convertir\/r\u00e9encoder vos donn\u00e9es avant de nous les transmettre, si n\u00e9cessaire.<\/td>\n<\/tr>\n
S\u00e9curit\u00e9 SSL<\/th>\nPour votre s\u00e9curit\u00e9, iggo.fr g\u00e8re le SSL avec https:\/\/letsencrypt.org\/ ou en auto-sign\u00e9. Vous pouvez donc choisir d’utiliser notre API en HTTP standard, ou en HTTPS. Il est entendu que nous vous recommandons l’utilisation de nos services en toute s\u00e9curit\u00e9 en utilisant nos certificats pour des transactions crypt\u00e9es.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n\n
\n\t

\n\tCette requ\u00eate est utilis\u00e9e pour acqu\u00e9rir les derni\u00e8res informations d'un collecteur<\/span>\n\t<\/h4>\n<\/blockquote>\n

URL<\/h2>\n

\n\n\tPOST<\/span> https:\/\/api.production.iggo.fr\/api\/v1\/<\/h4>\n

\n\n\tGET<\/span> https:\/\/api.production.iggo.fr\/api\/v1\/<\/h4>\n<\/div>\n
\n

Liste des param\u00e8tres<\/h2>\n

Voici la liste des param\u00e8tres disponibles pour utiliser notre API.
\nATTENTION : lorsque ceux-ci ne sont pas obligatoires, c’est qu’ils ont une valeur par d\u00e9faut.<\/p>\n\n\n\n\n\n\n\n\n\n
Param\u00e8tres<\/th>\nType<\/th>\nD\u00e9finition<\/th>\n<\/tr>\n<\/thead>\n
account<\/th>\nObligatoire<\/th>\nR\u00e9f\u00e9rence utilisateur AAA1234567. Disponible depuis votre extranet.<\/td>\n<\/tr>\n
APIkey<\/th>\nObligatoire<\/th>\nCl\u00e9 API de votre compte. Disponible depuis votre extranet.<\/td>\n<\/tr>\n
moduid<\/th>\nObligatoire, Array<\/th>\nNum\u00e9ro de s\u00e9rie du ou des collecteurs \u00e0 interroger<\/td>\n<\/tr>\n
ask<\/th>\nObligatoire<\/th>\nlastdata : liste les d\u00e9tails de vos mod’s<\/td>\n<\/tr>\n
string<\/th>\nOption<\/th>\nlower : retourne la r\u00e9ponse en minuscule.
\nupper : retourne la r\u00e9ponse en majuscule.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n

Liste des param\u00e8tres retours<\/h2>\n

Voici la liste des param\u00e8tres disponibles lors du retour de notre API.<\/p>\n\n\n\n\n\n\n\n\n
Param\u00e8tres<\/th>\nType<\/th>\nD\u00e9finition<\/th>\n<\/tr>\n<\/thead>\n
error<\/th>\n<\/th>\n1 erreur survenue, 0 commande trait\u00e9e<\/td>\n<\/tr>\n
date<\/th>\ndate<\/th>\nDate au format YYYYMMDD HHMMSS<\/td>\n<\/tr>\n
mods<\/th>\narray<\/th>\nInformations li\u00e9es aux collecteurs ARRAY[collectors][moduid]<\/td>\n<\/tr>\n
processTime<\/th>\nvar<\/th>\nDur\u00e9e en millisecondes pour traiter la demande<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n

Liste des param\u00e8tres collecteurs array<\/h2>\n

Voici la liste des param\u00e8tres disponibles lors du retour de notre API.<\/p>\n<\/div>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n
Param\u00e8tres<\/th>\nType<\/th>\nD\u00e9finition<\/th>\n<\/tr>\n<\/thead>\n
moduid<\/th>\nvar<\/th>\nNum\u00e9ro de s\u00e9rie du mod<\/td>\n<\/tr>\n
color<\/th>\nvar<\/th>\nCouleur attribu\u00e9e au mod<\/td>\n<\/tr>\n
date<\/th>\nvar<\/th>\nDate de la derni\u00e8re collecte<\/td>\n<\/tr>\n
trame<\/th>\njson<\/th>\nDonn\u00e9es envoy\u00e9es par le mod<\/td>\n<\/tr>\n
designation<\/th>\nvar<\/th>\nD\u00e9signation du mod<\/td>\n<\/tr>\n
unite<\/th>\nvar<\/th>\nUnit\u00e9 de la mesure<\/td>\n<\/tr>\n
designation_courte<\/th>\nvar<\/th>\nD\u00e9signation iggo du mod<\/td>\n<\/tr>\n
alerte<\/th>\nboolean<\/th>\nErreur 1 ou Erreur 0<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
\n

Exemples<\/h2>\n<\/div>\n
\n

Test cUrl<\/h2>\n

Test cUrl -> Commande<\/h3>\n
curl -# -k -d '{\"ask\":\"clastdata\" ,\"apikey\":\"bAnuHRn\" , \"account\":\"BVZ765843\", \"cuid\" : [\"B4E62D8BA335\",\"B4E62D8B9E79\"]}' -X POST https:\/\/api.production.iggo.fr\/api\/v1\/<\/code><\/pre>\n
Test cUrl -> R\u00e9ponse<\/h3>\n
\r\n{\r\n  \"error\": 0,\r\n  \"mods\": [\r\n    {\r\n      \"99887706\": {\r\n        \"moduid\": \"99887706\",\r\n        \"color\": \"87B752\",\r\n        \"date\": \"2018-10-23 14:12:14\",\r\n        \"trame\": \"{\\\"multdiv\\\":\\\"d2\\\",\\\"loop\\\":\\\"2\\\",\\\"temperature\\\":\\\"21.62\\\",\\\"battery\\\":\\\"862\\\",\\\"uptime\\\":\\\"4726624\\\",\\\"nexttime\\\":\\\"2048\\\",\\\"lrssi\\\":\\\"-73\\\",\\\"rssi\\\":\\\"-86\\\"}\",\r\n        \"designation\": \"Zone 1\",\r\n        \"unite\": \"Celcius\",\r\n        \"designation_courte\": \"Capteur temp\u00e9rature\",\r\n        \"alerte\": \"1\"\r\n      }\r\n    },\r\n    {\r\n      \"99887739\": {\r\n        \"moduid\": \"99887739\",\r\n        \"color\": \"337AB7\",\r\n        \"date\": \"2018-10-23 14:22:19\",\r\n        \"trame\": \"{\\\"multdiv\\\":\\\"d2\\\",\\\"loop\\\":\\\"\\\",\\\"temperature\\\":\\\"23.17\\\",\\\"battery\\\":\\\"966\\\",\\\"uptime\\\":\\\"2693791\\\",\\\"nexttime\\\":\\\"2048\\\",\\\"lrssi\\\":\\\"-60\\\",\\\"rssi\\\":\\\"-87\\\"}\",\r\n        \"designation\": \"Zone 2\",\r\n        \"unite\": \"Celcius\",\r\n        \"designation_courte\": \"Capteur temp\u00e9rature\",\r\n        \"alerte\": \"1\"\r\n      }\r\n    }\r\n  ],\r\n  \"date\": \"2018\/10\/23 16:33:24\",\r\n  \"count\": 2,\r\n  \"processTime\": 0.184398\r\n}\r\n<\/code><\/pre>\n<\/div>\n","protected":false},"featured_media":0,"parent":6338,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","doc_tag":[1010,1011],"yst_prominent_words":[563,1703,1702,1249,967,1680,1622,1032,1001,1006,1310,997,694,1030,1127,1679,1638,1689,1664,1669],"jetpack_likes_enabled":false,"_links":{"self":[{"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/docs\/6339"}],"collection":[{"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/comments?post=6339"}],"version-history":[{"count":0,"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/docs\/6339\/revisions"}],"up":[{"embeddable":true,"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/docs\/6338"}],"prev":[{"title":"Recueillir les informations de vos mod's","link":"https:\/\/www.iggo.fr\/docs\/api\/sondes\/recueillir-les-informations-de-vos-mods\/","href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/docs\/7552"}],"wp:attachment":[{"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/media?parent=6339"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/doc_tag?post=6339"},{"taxonomy":"yst_prominent_words","embeddable":true,"href":"https:\/\/www.iggo.fr\/api\/wp\/v2\/yst_prominent_words?post=6339"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}