Guide de l'API & Workflows

Endpoints Principaux

Route	Méthode	Description
/article/publish	POST	Valide et publie un article complet.
/article/validate	POST	Valide un article sans le publier.
/article/status/{uuid}	GET	Récupère le statut d'une publication (ex: RELEASED).
/linkage/publish	POST	Publie les liens véhicules (jusqu'à 100 par requête).
/asset/publish	POST	Déclare un nouveau fichier (image/PDF) pour obtenir une URL d'upload.

Workflow de Publication d'un Article

Le flux recommandé pour garantir l'intégrité des données est le suivant :

1. Publication de l'Article : /article/publish
2. Attente de Confirmation : Attendre le code HTTP 200 et l'UUID.
3. Délai de Propagation : Attendre environ 1 à 2 secondes que l'index se mette à jour.
4. Publication des Liens Véhicules : /linkage/publish

Gestion des Assets (Images / PDFs)

La gestion des fichiers media se fait en deux étapes :

1. Annonce : Envoyer les métadonnées sur /asset/publish. L'API retourne une preSignedURL (valide 10 min).
2. Upload : Envoyer le fichier binaire en PUT sur l'URL fournie (pas d'API Key requise pour cette étape).
3. Allocation : Lier l'image à l'article via le champ assets dans /article/publish ou via /article/asset/allocate.

Limites de l'API (Rate Limiting)

• Débit : Jusqu'à 10 requêtes par seconde par marque (brand).
• Parallélisation : Il est recommandé de traiter les requêtes pour un même article dans un seul thread pour éviter les conflits d'indexation.

Suppression de Données

• Article : /article/delete (supprime également les liens et accessoires liés).
• Lien : /linkage/delete (unitaire par requête).

Suppression massive

Évitez les suppressions massives pour faire un "reset". Préférez des mises à jour incrémentales pour ne pas perturber les consommateurs de données.