Intégrer Sowprog
à vos applications.
Sowprog expose une API REST en lecture et en écriture : récupérez la programmation des salles et festivals partenaires, ou poussez vos événements depuis votre propre outil. Clés API self-service, format JSON, mises à jour incrémentales.
Affichez votre programmation sur votre site WordPress
Deux plugins officiels permettent d'afficher votre programmation Sowprog directement sur votre site WordPress, sans ressaisie.
The Events Calendar
Plugin compatible avec The Events Calendar (TEC), l'extension événementielle la plus utilisée sur WordPress. Synchronisation automatique de vos événements Sowprog vers TEC.
Documentation du plugin →Events Manager Pro
Plugin compatible avec Events Manager Pro. Synchronisation automatique des événements, champs personnalisés, intégration avec votre thème WordPress existant.
Documentation du plugin →Récupérez la programmation via API REST
Plus de 10 médias et agendas culturels récupèrent automatiquement la programmation Sowprog via ce flux REST, en JSON ou XML. Il reste pleinement maintenu pour les intégrations existantes ; pour une nouvelle intégration, préférez l'API v2.
Endpoints disponibles
Liste des événements
GET https://agenda.sowprog.com/rest/v1_2/scheduledEvents
GET https://agenda.sowprog.com/rest/v1_2/scheduledEvents/search
Liste complète ou filtrée des événements de la programmation.
Événements par date
GET https://agenda.sowprog.com/rest/v1_2/scheduledEventsSplitByDate
GET https://agenda.sowprog.com/rest/v1_2/scheduledEventsSplitByDate/search
Événements regroupés par date de représentation.
Lieux
GET https://agenda.sowprog.com/rest/v1_2/locations
GET https://agenda.sowprog.com/rest/v1_2/locations/search
Liste complète ou filtrée des lieux et salles partenaires.
Types et styles d'événement
GET https://agenda.sowprog.com/rest/v1_2/eventTypes
GET https://agenda.sowprog.com/rest/v1_2/eventStyles
Référentiels des types (concert, théâtre, exposition...) et des styles musicaux.
Artistes et festivals
GET https://agenda.sowprog.com/rest/v1_2/artists
GET https://agenda.sowprog.com/rest/v1_2/festivals
Référentiels des artistes et des festivals associés aux événements.
Format de réponse
La racine de la réponse est scheduledEvents,
contenant une liste d'objets eventDescription.
Chaque événement contient au minimum :
id· identifiant uniqueversion· version de l'enregistrementcreationDate· date de créationmodificationDate· date de dernière modificationsoldOut· indicateur de complet- Vignettes (thumbnails) en 150px, 300px et 600px
Format de réponse choisi via le header Accept :
application/json ou application/xml.
Mises à jour incrémentales
Pour ne récupérer que les événements modifiés depuis votre dernière synchronisation,
ajoutez le paramètre modifiedSince avec un timestamp Unix
exprimé en millisecondes depuis le 1er janvier 1970.
Filtres de recherche
Sur les endpoints /search, vous pouvez combiner plusieurs critères.
Les paramètres se cumulent comme un ET logique.
API v2 : lecture et écriture en self-service
La nouvelle API Sowprog permet aux CMS, applications métiers et systèmes de billetterie de pousser leurs événements directement vers Sowprog : création complète en un appel (dates, tarifs, artistes, visuel, liens), publication, modification, dépublication. Et bien sûr la lecture de toute la programmation.
Créez votre compte, générez votre clé API depuis votre profil (en deux clics), et suivez la documentation complète de l'API v2 : authentification, endpoints, exemples de code, guide de migration depuis l'API v1.
Authentification
Toutes les requêtes nécessitent une authentification HTTP Basic Auth. Le token vous est fourni par Sowprog après inscription.
- Encodage : Base64 du couple
login:password - Header :
Authorization: Basic <token> - Token fourni à la création du compte ou sur demande à contact@sowprog.com
- Pas de token public, l'accès est nominatif
Tester l'API en 2 minutes
Avant d'intégrer l'API à votre application, vous pouvez la tester rapidement depuis votre navigateur ou avec un client REST.
Depuis votre navigateur
Ouvrez directement l'URL de l'endpoint dans Chrome, Firefox ou Safari. Le navigateur vous demandera votre login et mot de passe Sowprog.
Avec un client REST
Postman, Insomnia, REST Console ou simplement curl.
Configurez la méthode GET, les headers
Accept et Authorization.
Documentation complète
Documentation détaillée des ressources, schémas XSD, exemples de réponses et description complète des nœuds.
Accéder à la documentation v1_2 →Inscrivez-vous et accédez à l'API
Créez votre compte Sowprog en 2 minutes, générez votre clé API depuis votre profil et commencez à intégrer notre programmation dans votre application.