Aller au contenu principal

Employés

Endpoints pour la gestion des employés.

Liste des employés​

GET /b2b/v1/employe

Retourne tous les employés.

Réponse​

[
  {
    "idExterne": "EMP-001",
    "prenom": "Jean",
    "nom": "Dupont",
    "noMembre": "M-001",
    "courriel": "jean.dupont@example.com",
    "identifiantExterneEmployeur": "EMPL-001",
    "idUnique": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "derniereMAJ": "2024-01-15T10:30:00Z",
    "dateCreation": "2024-01-01T09:00:00Z"
  }
]

Exemple​

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

Obtenir un employé​

GET /b2b/v1/employe/{idExterne}

Paramètres​

NomEmplacementTypeDescription
idExternePathstringIdentifiant externe de l'employé

Exemple​

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

Créer un employé​

POST /b2b/v1/employe

Corps de la requête​

{
  "idExterne": "EMP-NEW",
  "prenom": "Marie",
  "nom": "Tremblay",
  "noMembre": "M-NEW",
  "courriel": "marie.tremblay@example.com",
  "identifiantExterneEmployeur": "EMPL-001",
  "telephonePrincipal": "514-555-1234",
  "ville": "Montréal",
  "province": "QC"
}

Exemple​

curl -X POST "https://api.macartememembre.com/b2b/v1/employe" \
  -H "X-Api-Key: votre-cle-api" \
  -H "Content-Type: application/json" \
  -d '{
    "idExterne": "EMP-NEW",
    "prenom": "Marie",
    "nom": "Tremblay",
    "noMembre": "M-NEW",
    "courriel": "marie.tremblay@example.com",
    "identifiantExterneEmployeur": "EMPL-001"
  }'

Modifier un employé​

PUT /b2b/v1/employe

Corps de la requête​

Même structure que POST. L'idExterne identifie l'employé à modifier.

Supprimer un employé​

DELETE /b2b/v1/employe/{idExterne}

Exemple​

curl -X DELETE "https://api.macartememembre.com/b2b/v1/employe/EMP-001" \
  -H "X-Api-Key: votre-cle-api"

Synchronisation​

POST /b2b/v1/employe/sync

Synchronise plusieurs employés en une seule opération (upsert).

Corps de la requête​

{
  "employes": [
    {
      "idExterne": "EMP-001",
      "prenom": "Jean",
      "nom": "Dupont",
      ...
    }
  ],
  "employeurs": [
    {
      "idExterne": "EMPL-001",
      "nom": "Entreprise ABC"
    }
  ],
  "objetsConsentement": []
}

Réponse​

{
  "created": 5,
  "updated": 10,
  "errors": [
    {
      "idExterne": "EMP-BAD",
      "message": "Courriel invalide"
    }
  ]
}