API pour les développeurs

Connectez Adsumio à vos outils avec une API REST sous /api/v1, décrite en OpenAPI 3 et incluse dans toutes les offres.

Authentification

Créez un jeton personnel dans l’administration, rubrique Jetons d’API, puis envoyez-le dans l’en-tête Authorization. Il n’est affiché qu’une fois à sa création, et sa révocation prend effet à la requête suivante. Le cookie de session n’est pas accepté.

curl -H "Authorization: Bearer $ADSUMIO_TOKEN" \
  https://adsumio.com/api/v1/o/my-organization/events

Choisir l’organisation

Ajoutez le préfixe /api/v1/o/{organizationSlug} à vos routes. Un utilisateur membre d’une seule organisation peut l’omettre.

Route	Usage	Permission
`GET /api/v1/me`	Utilisateur du jeton	Utilisateur authentifié
`GET /api/v1/organizations`	Organisations de l’utilisateur	Utilisateur authentifié
`GET /api/v1/organizations/{organizationSlug}`	Détail d’une organisation dont il est membre	Utilisateur authentifié
`GET /api/v1/events`	Liste des événements	`event.view`
`POST /api/v1/events`	Création d’un événement en brouillon	`event.create`
`GET /api/v1/events/{event}`	Détail d’un événement	`event.view`
`GET /api/v1/events/{event}/registrations`	Inscrits	`registration.view`
`GET /api/v1/events/{event}/staff`	Présence du staff	`staff.attendance.view`
`GET /api/v1/events/{event}/attendance`	Présence des participants	`registration.view`
`GET /api/v1/events/{event}/survey`	Résultats de l’enquête	`survey.results.view`

Listes et pagination

Les listes acceptent page (1 par défaut), per_page (20 par défaut, 100 au maximum), sort et direction (asc ou desc). Les événements se filtrent par status et se trient par starts_at ou title. Les inscrits se filtrent par status et se trient par created_at ou email.

Créer un événement

Envoyez un objet JSON avec title, startsAt, endsAt, timezone et locale (en ou fr), et en option capacity, description et location. L’événement est créé en brouillon.

curl -X POST -H "Authorization: Bearer $ADSUMIO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Forum 2027",
    "startsAt": "2027-03-12T09:00:00+01:00",
    "endsAt": "2027-03-12T18:00:00+01:00",
    "timezone": "Europe/Paris",
    "locale": "fr"
  }' \
  https://adsumio.com/api/v1/o/my-organization/events

Limites et erreurs

Un jeton est limité à 120 requêtes par minute. Toutes les erreurs ont la même forme :

{"error": {"code": "invalid", "message": "...", "fields": {"title": ["..."]}}}

Codes possibles : unauthorized, forbidden, not_found, organization_required, invalid, rate_limited, unavailable, server_error.

Description OpenAPI

Importez la description dans votre client ou générateur de code.

Télécharger openapi.yaml

Prêt à simplifier votre prochain événement ?

Créez votre compte en moins d’une minute. Aucune application à installer, aucune carte bancaire demandée.

Créer mon compte Tarifs