4.9 KiB
API MS-1
MS-1 API
L’API MS-1 permet aux partenaires d’accéder aux événements, catégories et inscriptions.
The MS-1 API allows partners to access events, categories and registrations.
Authentification
Authentication
Pour accéder à l’API, vous devez obtenir une clé API auprès de MS-1.
To access the API you must obtain an API key from MS-1.
Lors de la création de votre accès, MS-1 vous fournira :
When your access is created MS-1 will provide:
- une clé API
- l’URL de base de l’API
- an API key
- the API base URL
La clé API doit être envoyée dans l’entête HTTP suivant :
The API key must be sent in the following HTTP header:
X-API-Key: YOUR_API_KEY
Si la clé est invalide ou absente, l’API retourne :
If the API key is missing or invalid the API returns:
401 Unauthorized
Endpoints
Endpoints
GET /v1/events
Retourne la liste des événements accessibles au promoteur associé à la clé API.
Returns the list of events accessible to the promoter associated with the API key.
Paramètres optionnels
Optional parameters
| Paramètre | Description |
|---|---|
| start_date | filtre par date de début |
| end_date | filtre par date de fin |
| updated_since | retourne les événements modifiés après cette date |
Exemple
Example
GET /v1/events?start_date=2026-01-01&end_date=2026-12-31
Réponse
Response
{ "events": [ { "eve_id": 4501, "eve_nom_fr": "Triathlon Démo", "eve_lieu_fr": "Montréal", "eve_lieu_en": "Montreal", "eve_date_debut": "2026-06-21", "categories": [ { "category_id": 801, "epr_nom_fr": "Sprint", "epr_nom_en": "Sprint" } ] } ], "total": 1 }
GET /v1/events/{event_id}
Retourne les informations détaillées d’un événement.
Returns detailed information for an event.
Exemple
Example
GET /v1/events/4501
Réponse
Response
{ "event": { "eve_id": 4501, "eve_nom_fr": "Triathlon Démo", "eve_lieu_fr": "Montréal", "eve_lieu_en": "Montreal", "eve_date_debut": "2026-06-21", "categories": [ { "category_id": 801, "epr_nom_fr": "Sprint", "epr_nom_en": "Sprint" } ] } }
GET /v1/events/{event_id}/categories
Retourne toutes les catégories d’un événement.
Returns all categories for an event.
Exemple
Example
GET /v1/events/4501/categories
Réponse
Response
{ "event_id": 4501, "categories": [ { "category_id": 801, "eve_id": 4501, "epr_type_fr": "Triathlon", "epr_type_en": "Triathlon", "epr_nom_fr": "Sprint", "epr_nom_en": "Sprint" } ] }
GET /v1/events/{event_id}/registrations
Retourne les inscriptions pour un événement.
Returns registrations for an event.
Paramètres optionnels
Optional parameters
| Paramètre | Description |
|---|---|
| updated_since | retourne les inscriptions modifiées après cette date |
| page | pagination |
| per_page | nombre d’éléments |
Exemple
Example
GET /v1/events/4501/registrations
Réponse
Response
{ "registrations": [ { "registration_id": 98001, "event_id": 4501, "first_name": "John", "last_name": "Doe", "email": "participant@example.com", "category_id": 801, "order_id": "ORD-10001", "payment_status": "paid", "custom_questions": [ { "que_id": 12, "que_question_fr": "Grandeur de chandail", "que_question_en": "Tshirt size", "reponse": "M" } ] } ] }
Limitations
Limitations
Chaque clé API donne accès uniquement aux événements associés au promoteur.
Each API key only provides access to events associated with the promoter.
Support
Support
Pour toute demande d’accès ou question technique, contactez MS-1.
For API access or technical questions, contact MS-1.