<aside> ℹ️ Il existe 2 grands types d’offres dites “individuelles” au sein du pass Culture :
Pour tout savoir sur les offres individuelles éligibles au pass Culture, voir notre FAQ.
</aside>
L’API offres individuelles produits permet de lire, créer et modifier des offres pour des produits.
API offres individuelles produits
L’API offres individuelles événements permet de lire, créer et modifier des offres d’événements.
API offres individuelles événements
L’API réservations individuelles permet de lire l’ensemble des réservations associées à une offre individuelle et de valider ou d’invalider une réservation, reproduisant le fonctionnement du Guichet pass Culture pro. Cette API offre également la possibilité de gérer en temps réel les réservations individuelles et d’afficher directement dans l’application pass Culture les informations d’un billet.
API réservations individuelles
L’API offres collectives permet de lire, créer et modifier des offres collectives destinées à des groupes scolaires, puis d’en suivre la réservation.
Depuis le 22/01/2023, l'utilisation des API pass Culture est limité à 200 appels par clé par minute. Si vous atteignez ce seuil alors nous renvoyons une erreur 429 Too Many Requests
et vous devez reporter vos requêtes.
Les dates des offres d’événement sont stockées en UTC et affichées aux utilisateurs de nos interfaces dans le créneau horaire des lieux qui les hébergent.
Tout champ renvoyé par une route patch/ est considéré comme modifié, même si la valeur envoyée est identique à la valeur originale.
Notamment, inclure le champ beginningDatetime
lors de la modification du nombre de places disponibles pour une date d’événement déclenche la procédure de report même si la date envoyée est inchangée.
<aside> 🔗 Revenir à la page pass Culture - Intégrations techniques
voir aussi : Authentification et autorisation des appels API pass Culture
Environnement d'intégration des API pass Culture
API exposées par le pass Culture
☝️ Informations génériques valables pour toutes les API pass Culture
</aside>
<aside> ℹ️ Pour toute question relative à l’intégration des API pass Culture ne trouvant pas réponse dans cette documentation, vous pouvez écrire à [email protected].
Pour toute question relative à l’utilisation du pass Culture par ses bénéficiaires (jeunes, acteurs culturels, établissements scolaires), merci de consulter la FAQ dédiée.
</aside>