Skip to main content

Créer une Étiquette (Label)

Cette requête permet d'associer (bind) une étiquette électronique (label) existante au système Horsplace en utilisant son adresse MAC et en lui attribuant un nom.

Méthode : POST

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

En-têtes :

CléValeurDescription
X-API-KEY{{apiKey}}Votre clé d'API unique.
Content-Typeapplication/jsonType de contenu de la requête.

Corps de la requête (JSON) :

{
"mac": "00:11:22:AA:BB:CC", // Adresse MAC de l'étiquette à associer
"name": "Étiquette Rayon Frais - Produit X" // Nom à attribuer à cette étiquette dans le système
}

Note : Cette opération enregistre l'étiquette avec sa MAC et un nom. D'autres détails (type, station de base associée, modèle, etc.) sont généralement gérés par des requêtes de mise à jour ultérieures ou des processus d'appairage spécifiques.

Réponses possibles :

  • 200 OK (ou 201 Created selon l'API Horsplace distante) : Étiquette associée avec succès. La réponse contiendra les détails de l'association ou de l'étiquette.
  • 400 Bad Request: La requête est malformée ou des informations sont manquantes.
  • 422 Unprocessable Entity: Les données fournies ne sont pas valides (par exemple, ID déjà existant, baseStationId invalide).

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

{
// La réponse exacte dépend de l'API Horsplace distante.
// Elle pourrait inclure un ID assigné par le système Horsplace, le nom, la MAC, etc.
"id": "horstable_assigned_label_id_789",
"name": "Étiquette Rayon Frais - Produit X",
"mac": "00:11:22:AA:BB:CC",
"status": "bound" // ou un statut initial
// ... autres champs retournés par l'API Horsplace.
}