Skip to main content

[Admin] Créer un modèle

Cette requête permet de créer un nouveau modèle (template) dans le système Horsplace.

Méthode : POST

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

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

{
"name": "Nom du Modèle",
"materialId": "identifiant_du_materiel_de_fond", // Optionnel: ID d'une image de fond pré-uploadée
"styleId": "identifiant_du_style", // Optionnel: ID d'un style prédéfini
"width": 800, // Largeur du modèle en pixels
"height": 600 // Hauteur du modèle en pixels
}

Note : materialId et styleId sont des identifiants de ressources existantes. Les elements du modèle (champs de texte, images, etc.) sont généralement ajoutés/gérés via une interface de conception ou des requêtes de mise à jour ultérieures spécifiques à la conception du contenu du modèle.

Réponses possibles :

  • 201 Created: Modèle créé avec succès. Les détails du modèle créé sont retournés.
  • 400 Bad Request: La requête est malformée ou des informations sont manquantes dans le corps de la requête.
  • 422 Unprocessable Entity: Les données fournies ne sont pas valides (par exemple, un nom de modèle déjà existant ou des dimensions incorrectes).

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

{
// La réponse exacte dépend de l'API Horsplace distante.
// Typiquement, elle contiendrait l'ID du modèle créé et les champs fournis.
"id": "horstable_template_id_12345",
"name": "Nom du Modèle",
"materialId": "identifiant_du_materiel_de_fond",
"styleId": "identifiant_du_style",
"width": 800,
"height": 600,
"created_at": "YYYY-MM-DDTHH:mm:ssZ",
"updated_at": "YYYY-MM-DDTHH:mm:ssZ"
// ... et potentiellement d'autres champs retournés par l'API Horsplace.
}