Liste électorale (Votez)
Endpoints pour consulter la liste électorale d'une campagne, envoyer les jetons de vote et mettre à jour le droit de vote unitaire. Module requis : Votez.
Toutes les routes sont sous le préfixe /b2b/v1/campagnes/{campagneId}/liste-electorale.
Liste électorale
GET /b2b/v1/campagnes/{campagneId}/liste-electorale
Vue agrégée des votants avec leur identité, droit de vote et statut « a voté ».
Filtres (query string)
| Nom | Type | Description |
|---|---|---|
identifiant | string | Égalité stricte |
courriel | string | Recherche partielle |
nom | string | Recherche partielle sur nom ou prenom |
droitDeVote | bool | Filtre par droit de vote |
aVote | bool | Filtre par statut « a voté » |
syndicatIdExterne | string | Filtre par syndicat |
Réponse
[
{
"id": "...",
"identifiant": "M-001",
"courriel": "alice@example.com",
"nom": "Tremblay",
"prenom": "Alice",
"droitDeVote": true,
"aVote": false,
"syndicatNom": "Syndicat",
"employeIdExterne": "EMP-001",
"syndicatIdExterne": "SYND001",
"commentaire": null
}
]
employeIdExterne et syndicatIdExterne permettent de corréler avec votre système externe.
Envoyer le jeton de vote
POST /b2b/v1/campagnes/{campagneId}/liste-electorale/{votantId}/envoyer-jeton
Envoie le courriel contenant le lien personnalisé de vote, en utilisant le modèle EnvoiLienVote configuré sur la campagne. Pas de corps de requête.
L'opération est idempotente sur l'état mais envoie un nouveau courriel à chaque appel.
Erreurs possibles
| Code | HTTP | Signification |
|---|---|---|
Votant.NotFound | 404 | Le votant n'existe pas dans la campagne |
Votant.EstRadie | 400 | Le votant est radié — envoi bloqué |
Campagne.VoteTermine | 400 | La campagne est terminée — envoi de masse bloqué |
Mettre à jour le droit de vote (unitaire)
PUT /b2b/v1/campagnes/{campagneId}/liste-electorale/{votantId}/droit-de-vote
Active ou retire le droit de vote pour un seul votant. Pour 10 votants ou plus, préférez POST /votants/droits-de-vote (lot).
Corps de la requête
{
"droitDeVote": true,
"envoyerJeton": false
}
| Champ | Type | Description |
|---|---|---|
droitDeVote | bool | Nouvelle valeur du droit de vote |
envoyerJeton | bool | Si true et droitDeVote = true, envoie automatiquement le jeton de vote |
Erreurs possibles
| Code | HTTP | Signification |
|---|---|---|
Votant.NotFound | 404 | Le votant n'existe pas |
Votant.EstRadie | 400 | Le votant est radié |