API B2B

L'API B2B permet d'interagir directement avec MCM via des appels HTTP REST.

Recommandation

Pour les applications .NET, nous recommandons d'utiliser MCM.ApiProxy qui encapsule cette API avec des types forts et une gestion d'erreurs simplifiée.

URL de base

Environnement	URL
Production	https://api.macartememembre.com/b2b/v1
Staging	https://api-staging.macartememembre.com/b2b/v1

Authentification

Toutes les requêtes doivent inclure l'en-tête d'authentification :

X-Api-Key: votre-cle-api

Format des requêtes

• Content-Type: application/json
• Accept: application/json

Format des réponses

Succès

{
  "data": { ... }
}

Erreur

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "Bad Request",
  "status": 400,
  "detail": "Description de l'erreur"
}

Codes HTTP

Code	Signification
200	Succès
201	Créé
204	Succès sans contenu
400	Requête invalide
401	Non authentifié
403	Non autorisé
404	Non trouvé
409	Conflit
500	Erreur serveur

Exemple cURL

curl -X GET "https://api.macartememembre.com/b2b/v1/employe" \
  -H "X-Api-Key: votre-cle-api" \
  -H "Accept: application/json"

Endpoints disponibles

Ressource	Endpoint	Description
Employés	/employe	Gestion des employés
Employeurs	/employeur	Gestion des employeurs
Formulaires	/formulaire	Liste des formulaires
Consentements	/consentement	Historique des consentements
Objets Consentement	/objetconsentement	Types de consentement
Champs Utilisateur	/champutilisateur	Champs personnalisés
Courriels	/courriel	Envoi de courriels

Versioning

L'API est versionnée via l'URL. La version actuelle est v1.

/b2b/v1/employe