Développeurs · API
Intégrer Sowprog
à vos applications.
Sowprog expose un webservice REST listant la programmation des salles et festivals partenaires. Plugins WordPress, API JSON ou XML, authentification par Basic Auth, mises à jour incrémentales.
Plugins WordPress
Affichez votre programmation sur votre site WordPress
Deux plugins officiels permettent d'afficher votre programmation Sowprog directement sur votre site WordPress, sans ressaisie.
Plugin
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 →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 →Webservices REST
Récupérez la programmation via API REST
Plus de 10 médias et agendas culturels récupèrent automatiquement la programmation Sowprog via une API REST publique, en JSON ou XML.
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.
# Exemple de réponse JSON
{
"scheduledEvents": [
{
"id": 42,
"version": 3,
"creationDate": "2026-04-01...",
"modificationDate": "2026-04-15...",
"soldOut": false,
"eventDescription": { ... }
}
]
}
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.
# Tous les événements modifiés depuis ce timestamp
GET .../scheduledEvents?modifiedSince=1349648143355
Filtres de recherche
Sur les endpoints /search, vous pouvez combiner plusieurs critères.
Les paramètres se cumulent comme un ET logique.
# Événements gratuits dans les départements 75 et 92
GET .../scheduledEvents/search
?location.contact.department=75
&location.contact.department=92
&freeAdmission=true
Bêta
API en écriture
Une nouvelle API en lecture/écriture est en phase de test. Elle permet à des CMS, applications métiers ou systèmes de billetterie de pousser leurs événements directement vers Sowprog, pour synchronisation avec les agendas partenaires.
Accès sur demande
L'API en écriture est en bêta privée. Pour obtenir un accès, contactez-nous à contact@sowprog.com en précisant votre cas d'usage et le volume d'événements prévu.
Sécurité
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
# Header HTTP
Authorization: Basic dXNlcjpwYXNzd29yZA==
# Génération du token (curl)
echo -n "user:password" | base64
Démarrer
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.
Méthode 1
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.
https://agenda.sowprog.com/rest/v1_2/scheduledEvents
Méthode 2
Avec un client REST
Postman, Insomnia, REST Console ou simplement curl.
Configurez la méthode GET, les headers
Accept et Authorization.
curl -H "Accept: application/json" \
-u user:password \
https://agenda.sowprog.com/rest/v1_2/scheduledEvents
Documentation
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 →Démarrer
Inscrivez-vous et accédez à l'API
Créez votre compte Sowprog en 2 minutes, recevez votre token d'authentification et commencez à intégrer notre programmation dans votre application.