Skip to main content

Mettre à Jour une Étiquette (Label)

Cette requête permet de mettre à jour les informations d'une étiquette (label) existante en utilisant son identifiant. Cela peut inclure la modification de son modèle associé, des données affichées, ou de ses champs personnalisés.

Méthode : PUT

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

Paramètres de chemin :

Aucun paramètre de chemin. L'identifiant de l'étiquette doit être fourni dans le corps de la requête.

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) :

Fournissez les champs de l'étiquette que vous souhaitez modifier.

{
"id": "LABEL_XYZ_001", // ID de l'étiquette à mettre à jour (obligatoire)
"name": "Étiquette Produit A123 (Nouveau Nom)" // Nouveau nom pour l'étiquette (optionnel)
// Le contrôleur proxy actuel ne transmet que 'id' et 'name'.
// Pour mettre à jour d'autres champs (currentTemplateId, status, customFields, data),
// l'API Horsplace distante pourrait avoir des endpoints spécifiques ou attendre plus de champs ici,
// ce qui nécessiterait une modification du contrôleur proxy.
}

Note : L' id dans le corps est obligatoire. Le champ name est le seul autre champ modifiable via ce contrôleur proxy spécifique.

Réponses possibles :

  • 200 OK: Étiquette mise à jour avec succès. Les détails mis à jour sont retournés.
  • 400 Bad Request: La requête est malformée ou des informations sont manquantes.
  • 404 Not Found: L'étiquette avec l'identifiant spécifié n'a pas été trouvée.
  • 422 Unprocessable Entity: Les données fournies ne sont pas valides (par exemple, currentTemplateId invalide).

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

{
// La réponse exacte dépend de l'API Horsplace distante.
"id": "LABEL_XYZ_001",
"name": "Étiquette Produit A123 (Nouveau Nom)",
// ... autres champs potentiellement retournés par l'API Horsplace
"updatedAt": "YYYY-MM-DDTHH:mm:ssZ"
}