Skip to main content

Récupérer l’État Actuel de la LED d’une Étiquette

Cette requête permet de récupérer l'état actuel de la LED (lampe) d'une étiquette électronique spécifique.

Méthode : GET

URL : {{baseUrl}}/api/horstable/label/getLampStatus/{taskId}

Paramètres de chemin :

ParamètreTypeDescription
taskIdstringL'identifiant de la tâche de commande de LED ou potentiellement l'identifiant (MAC) de l'étiquette. L'API Horsplace distante déterminera comment interpréter ce taskId.

En-têtes :

CléValeurDescription
X-API-KEY{{apiKey}}Votre clé d'API unique.

Corps de la requête :

Aucun corps de requête n'est nécessaire pour ce point d'API.

Réponses possibles :

  • 200 OK: État de la LED récupéré avec succès.
  • 404 Not Found: L'étiquette avec l'identifiant spécifié n'a pas été trouvée, ou la tâche/l'état de la LED n'est pas disponible.

Exemple de réponse (Succès - 200) :

{
"taskId": "some_task_or_label_id_XYZ_001", // Correspond au taskId fourni dans la requête
// Les champs suivants dépendent de ce que l'API Horsplace distante retourne pour un taskId.
// Si taskId est un labelId/MAC, cela pourrait être l'état actuel de la LED de cette étiquette.
"labelMac": "00:11:22:AA:BB:CC", // Potentiellement l'adresse MAC si taskId y correspond
"lampStatus": "on", // "on", "off", "flash_slow", "flash_fast", "unknown"
"color": "red", // Couleur actuelle si applicable
"lastCommandAt": "2025-06-02T23:20:00Z", // Heure de la dernière commande envoyée
"reportedAt": "2025-06-02T23:22:00Z" // Heure à laquelle cet état a été rapporté
}