API Reference

MCM.ApiProxy fournit des clients typés pour interagir avec l'API B2B de Ma Carte de Membre. Chaque client est injecté automatiquement via l'injection de dépendances.

Clients disponibles

Client	Description	Interface
Employés	Gestion des employés/membres	IEmployesClient
Employeurs	Gestion des employeurs	IEmployeursClient
Formulaires	Récupération des formulaires	IFormulaireClient
Consentements	Historique des consentements	IConsentementClient
Objets Consentement	Définition des objets de consentement	IObjetsConsentementClient
Champs Utilisateur	Champs personnalisés	IChampUtilisateurClient
Courriels	Envoi de courriels	ICourrielClient
Synchronisation	Synchronisation en lot	ISyncClient

Module Votez

Client	Description	Interface
Campagnes	Gestion des campagnes de vote	ICampagnesClient
Questions	Gestion des questions et options	IQuestionsClient
Votants	Gestion des votants	IVotantsClient

Injection des clients

Tous les clients sont enregistrés automatiquement lors de l'appel à AddMcmApiClient(). Vous pouvez les injecter dans vos services :

public class MonService
{
    private readonly IEmployesClient _employesClient;
    private readonly IEmployeursClient _employeursClient;

    public MonService(
        IEmployesClient employesClient,
        IEmployeursClient employeursClient)
    {
        _employesClient = employesClient;
        _employeursClient = employeursClient;
    }
}

Pattern ErrorOr

Toutes les méthodes retournent un ErrorOr<T>. Ce pattern permet de gérer les erreurs de manière explicite :

var result = await _employesClient.GetAllEmployes();

if (result.IsError)
{
    // Gérer l'erreur
    foreach (var error in result.Errors)
    {
        Console.WriteLine($"{error.Code}: {error.Description}");
    }
    return;
}

// Utiliser la valeur
var employes = result.Value;

Types de retour courants

Type	Description
ErrorOr<T>	Résultat avec valeur ou erreur(s)
ErrorOr<Success>	Opération sans valeur de retour
ErrorOr<IEnumerable<T>>	Liste de résultats

Gestion des erreurs

Voir le guide Gestion des erreurs pour plus de détails sur les codes d'erreur et leur traitement.