L'API EMI fournit une interface programmable pour envoyer des données directement au système EMI sans utiliser l'interface graphique. Cela permet une intégration transparente avec diverses applications et systèmes, facilitant ainsi l'automatisation des processus et la gestion des données.

Untitled

Comment se connecter à l’API ?

Avant d'envoyer des données à l'API d'EMI, vous devez obtenir un token d'accès. Ce token assure que les requêtes à l'API sont sécurisées et autorisées. Pour obtenir ce token, il vous nous en demandé l’accès en nous envoyer une demande par mail à [email protected]. Ensuite lors d’une requête sur l’api, il faut mettre dans le header : “Authorization” et en valeur : “Bearer {votre_access_token}”.

Envoyer des données

URL : https://emi.imageau.com/api/data Ce endpoint permet d’ajouter des données sur un capteur dans EMI. Les dates des données sont entendu sur la timezone Europe/Paris ou au format ISO-8601

Corps de la requête

Le corps de la requête doit contenir les données que vous souhaitez envoyer. Ces données doivent être formatées en JSON.

Le flag est une chaine de caractère unique qui permet d’identifier le capteur sur lequel envoyer la donnée.

Exemple de requête pour de la donnée horaire sur 2 capteurs différents:

{
  "data": [
    {
      "flag": "flag_1",
			"date": "2024-01-01 00:01:00",
      "value": 10.5
    },
    {
      "flag": "flag_1",
			"date": "2024-01-01 00:02:00",
      "value": 10.8
    },
    {
      "flag": "flag_2",
			"date": "2022-03-21 00:01:00",
      "value": 108.4
    },
        {
      "flag": "flag_2",
			"date": "2022-03-21 00:02:00",
      "value": 108.9
    }
  ]
}

Réponse

Si les données sont envoyées avec succès, l'API retournera une réponse confirmant le succès de l'opération. Dans le cas contraire, l'API renverra un message d'erreur

Gestion des erreurs

Exemples de codes d'erreur :