Feature

Découvrez Analysis Endpoints

Donnez une URL HTTP à une Analysis Luau pour vos formulaires, webhooks, configurations d'appareils et réponses destinées à vos dashboards.

TagoIO Team ·
Découvrez Analysis Endpoints

Une Analysis peut déjà traiter vos données. Avec Analysis Endpoints, elle peut aussi répondre à l’application qui l’a appelée. Donnez à une Analysis Luau sa propre URL HTTP, envoyez-lui une requête et recevez le résultat du script dans le même appel.

Un formulaire de dashboard peut vérifier la validité d’une consigne de température avant de l’enregistrer. Un appareil peut récupérer sa configuration, ou un autre service peut envoyer un webhook et recevoir une confirmation. Cette logique de requête et de réponse reste dans TagoIO, aux côtés de vos données d’appareils et de vos règles d’accès, sans service web distinct à déployer.

Votre Analysis, à sa propre URL

Une Analysis Luau avec sa propre URL HTTP, un accès Public ou Token et des réponses JSON, CSV, HTML ou des redirections

Renvoyez du JSON à un appareil, envoyez un export CSV à un tableur ou servez une page HTML. Votre script contrôle la réponse, y compris les redirections.

Utilisez l’accès Public pour les requêtes sans token, ou l’accès Token pour les appelants authentifiés. Access Management contrôle quels utilisateurs Run et quelles Analysis peuvent appeler votre code. Votre script peut utiliser l’identité de l’appelant pour décider de la réponse à renvoyer.

Affichez la réponse dans votre dashboard

Une consigne de 50 °C saisie dans un dashboard est rejetée : l'Analysis renvoie une erreur de champ, le formulaire affiche la plage autorisée de 5 à 30 et rien n'est enregistré

Les Custom Dashboards dans Admin et TagoRUN appellent les Endpoints avec la session de la personne qui les consulte. Aucun token n’a besoin d’être intégré au HTML du dashboard.

Rejetez une consigne de thermostat hors plage et affichez l’erreur à côté du champ avant tout enregistrement. L’exemple de validation d’un formulaire de dashboard montre comment relier le formulaire à votre Analysis.

Recevez des webhooks et créez un middleware

Un service météo envoie 23,5 °C et 64 % d'humidité à une Analysis Luau, qui valide les données reçues, convertit la température en 74,3 °F, enregistre les mesures et renvoie une confirmation dans le même appel

Recevez des événements provenant de systèmes externes sans déployer de serveur de webhooks. Un service météo peut, par exemple, envoyer la température et l’humidité dans une seule requête. Votre Analysis peut valider les mesures, convertir les degrés Celsius en Fahrenheit, enregistrer les résultats sur l’appareil correspondant et renvoyer une confirmation.

Utilisez un Endpoint comme middleware lorsqu’une autre application envoie des données dans un format différent ou attend une réponse personnalisée. Votre script peut valider et transformer les données reçues, exploiter les ressources TagoIO et renvoyer le format attendu par cette application. L’exemple de réception d’un webhook fournit un récepteur complet.

Publiez un formulaire sans héberger de site web

Un formulaire de retour d'expérience servi par un Endpoint envoie un message, l'enregistre dans les données d'un appareil et reçoit une page de remerciement

Un Endpoint peut renvoyer un formulaire HTML, recevoir les données soumises, les enregistrer et renvoyer une page de remerciement. L’exemple de formulaire de retour d’expérience contient tout le nécessaire pour le créer.

D’autres exemples montrent comment fournir la configuration d’un appareil et exporter des mesures au format CSV.

Développez et testez dans Admin

Try it dans Admin envoie une requête JSON à /orders et affiche une réponse 200 OK qui reprend le corps de la requête

Testez les requêtes dans Admin et examinez la réponse que votre application recevra avant de la connecter. TagoAI peut vous aider à écrire le script Luau et à activer son Endpoint.

Pour commencer

Analysis Endpoints est disponible dans toutes les offres. Les exécutions Luau ne sont pas décomptées de votre limite Analysis Service ; les opérations sur les appareils et les autres ressources restent soumises à leurs limites habituelles.

Consultez les limites d’appels et de taille de payload pour dimensionner votre application.

Lisez le guide Analysis Endpoints, puis ouvrez une Analysis Luau dans Admin pour activer votre Endpoint.