v1 · REST · JSON

Votre catalogue en entrée, tous vos visuels en sortie.

L'API Veeton Studio donne à votre PIM, votre DAM ou votre back-office un accès programmatique au pipeline qu'utilise le tableau de bord : importez vos produits, lancez l'Embellisseur produit et des shootings photo, et récupérez chaque visuel avec une URL signée, une ligne par produit.

Démarrage rapide Référence API

curl https://api.veeton.com/v1/products?limit=3 \
  -H "Authorization: Bearer $VEETON_KEY"

Importer vos produits

Deux chemins, taillés pour deux usages. Un catalogue entre sous forme de fichier ; un produit seul entre en deux appels depuis un formulaire.

POST /v1/importsImporter un catalogueUne ligne JSON par produit avec les URL de ses photos. Jusqu'à 2 000 produits par appel, validés en bloc, traités comme un job avec un fichier de résultats par ligne. Commencez ici.POST /v1/images → POST /v1/productsCréer un produitEnvoyez les photos, puis créez le produit avec leurs identifiants. Le bon format pour un formulaire de back-office ou une correction manuelle.

Ce que vous pouvez faire

POST /v1/tasks/…Générer des rendusL'Embellisseur produit pour un packshot propre sur l'arrière-plan de votre choix, le shooting photo pour le produit porté par un mannequin. Les deux retournent une tâche à interroger ou à suivre par webhook.GET /v1/imagesSynchroniser un PIM ou un DAMChaque visuel que nous détenons, rattaché à son produit, paginé par cursor. Demandez ce qui a changé depuis votre dernier passage, suppressions comprises, ou figez une sélection dans un fichier.POST /v1/webhooksRecevoir des webhooksDes livraisons signées pour les événements de tâche, d'import et d'export, réessayées avec backoff pendant six heures. L'interrogation périodique reste toujours possible en repli.Idempotency-KeyRéessayer sans risqueEnvoyez une clé avec chaque écriture : une requête rejouée renvoie le même résultat au lieu d'un doublon.

URL de base

https://api.veeton.com/v1

Ciblez explicitement /v1. Les changements au sein d'une version majeure sont additifs.

Authentification

Authorization: Bearer ak_…

Des clés machine générées dans le tableau de bord. Détails

Statut

GET/v1/tasks/{id}

Chaque job asynchrone a un endpoint de statut ; interrogez-le ou laissez un webhook vous prévenir.