Concevoir un contrat d'entrées de modèle utile
Exposez des entrées texte, nombre, booléen, couleur et média compréhensibles, sans dévoiler les détails internes des calques.
Un modèle est un projet JsonCut normal avec un contrat public volontairement réduit. Le meilleur contrat décrit ce que l'opérateur veut changer, pas la façon dont l'éditeur le stocke.
Nommer le résultat
Préférez Titre, Image produit et Offre aux ID internes des calques. Ajoutez un exemple et ne rendez une entrée obligatoire que si le design ne peut vraiment pas s'en passer.
Garder volontairement peu de types
Utilisez texte, nombre, booléen, couleur, image, vidéo ou audio. Un système de types compact rend les formulaires, le mappage CSV, la validation API et la création par agent plus faciles à comprendre.
Inspecter avant de remplir
Récupérez le contrat d'entrées du modèle avant d'envoyer des valeurs. Votre intégration reste ainsi à jour quand des champs facultatifs sont ajoutés dans une version ultérieure du modèle.
GET /api/v2/templates/{templateId}/inputs
POST /api/v2/templates/{templateId}/renders