Traduit de English par IA ·
Brian a raison, et il te manque aussi le préfixe de l’organisation. J’ai monté à peu près la même chose pour une chambre froide l’an dernier.1. API Keys (Developer menu) > New API Key. Sous Module permissions, donne uniquement un accès en lecture seule à la télémétrie, rien d’autre. Définis une liste d’adresses IP autorisées sur celle du bureau et note la date d’expiration : par défaut 90 jours, un an au maximum. Mets un rappel dans l’agenda, la nôtre a expiré un samedi.2. Tous les chemins de gestion se trouvent sous le tenant :
GET https://<host>/tenant/<tenantId>/api/telemetry/latest?kind=iot_device&entityId=<deviceId>&keys=level_pct
Authorization: Bearer sk_live_...La réponse ressemble à {« latest »: {« level_pct »: {« ts »: …, « value »: 91.2}}}. Compare le ts avec le précédent pour ne pas faire biper deux fois sur la même mesure.3. Gère le 429 et attends le nombre de secondes indiqué par Retry-After. Interroge toutes les 30 s environ, le réservoir ne se remplit pas en 5 s.L’autre solution, si tu veux un résultat instantané : fais du Pi un device à part entière, crée une règle sur le réservoir qui lui envoie une commande lorsque level_pct dépasse 90, et laisse le Pi attendre sur GET /api/v1/rpc avec son propre token de device. Plus de pièces mobiles, pas de polling. Pour un buzzer, je prendrais la clé API. Les conventions sont décrites dans REST API basics.
Brian’s right, and you’re also missing the organisation prefix. I set up nearly the same thing for a chiller room last year.
1. API Keys (Developer menu) > New API Key. Under Module permissions give it read-only telemetry, nothing else. Set an IP allowlist to the office’s address, and note the expiry, default is 90 days, a year at most. Put a reminder in the calendar, ours expired on a Saturday.
2. Every management path sits under the tenant:
GET https://<host>/tenant/<tenantId>/api/telemetry/latest?kind=iot_device&entityId=<deviceId>&keys=level_pct
Authorization: Bearer sk_live_...Answer looks like {« latest »: {« level_pct »: {« ts »: …, « value »: 91.2}}}. Compare the ts with the previous one so you don’t buzz twice on the same reading.
3. Handle 429 and wait the Retry-After seconds. Poll every 30 s or so, the tank doesn’t fill in 5.
The other route, if you want it instant: make the Pi a device itself, have a rule on the tank send it a command when level_pct rises above 90, and let the Pi wait on GET /api/v1/rpc with its own device token. More moving parts, no polling. For a buzzer I’d take the API key. Conventions are on REST API basics.