<aside> ☝ Il est rappelé que les offres créées par les acteurs culturels via l’API doivent respecter les Conditions Générales d’Utilisation.
</aside>
Cette API propose 2 systèmes de création d’offres en fonction de la catégorie :
pour les catégories Livre papier
, CD
ou Vinyles et autres supports
, la création se fait obligatoirement en indiquant un EAN, un prix et une quantité. Le pass Culture s’occupe de reconstituer le reste de l’offre via des bases de données externes (fournies par notre partenaire Titelive)
<aside> ℹ️ Pour publier une offre par l’EAN de son produit, il faut que ce produit existe dans la base de données du pass Culture. Voici quelques exemples de produits existants à utiliser pour vos tests en environnement d’intégration :
pour les autres catégories autorisées, listées dans cette route, la création se fait avec l’ensemble des métadonnées. Une route complémentaire est disponible pour ajouter l’image de l’offre.
A partir du moment où une offre est créée avec un EAN, quelque soit la façon dont l’offre a été créée alors il est possible de modifier l’offre avec la route /ean
L’API permet de créer aussi bien des offres physique que digital.
Les offres individuelles produits créées par API sont visibles sur le portail pass Culture pro. En revanche, ces offres ne sont pas manuellement éditables sur le portail pass Culture pro, à l’exception de quelques actions :
À l’inverse, les offres individuelles produits créées par le portail pass Culture pro ne sont pas modifiables par API, à l’exception de quelques actions :