MobileCitoyenExchange
Gestion de l'authentification — login, logout et changement de mot de passe.
Authentifie un utilisateur et retourne un token JWT.
Les identifiants de connexion (nom d'utilisateur et mot de passe).
Un token JWT contenant les informations de l'utilisateur et ses rôles.
Le token est valide pendant 20 minutes.
Endpoint public — aucune authentification requise.
Le token JWT retourné contient les claims suivants :
- **NameIdentifier** : identifiant unique de l'utilisateur
- **Name** : nom d'utilisateur
- **Email** : adresse email
- **GivenName** : prénom
- **Surname** : nom de famille
- **Gender** : sexe (M ou F)
- **Role** : rôle(s) de l'utilisateur (Admin, RH, GrandCommis, Fonctionnaire)
- **MinistereId** : identifiant du ministère (si applicable)
- **SectionId** : identifiant de la section (si applicable)
Exemple de requête :
POST /api/auth/login
{
"username": "votre_nom_utilisateur",
"password": "votre_mot_de_passe"
}
Exemple de réponse :
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expiration": "2024-01-15T10:20:00Z",
"username": "jdupont",
"prenom": "Jean",
"nom": "Dupont",
"sexe": "M",
"email": "jdupont@mef.gouv.ht",
"ministereId": "1112",
"sectionId": "1112001",
"roles": ["GrandCommis"]
}
Retourne le token JWT avec les informations de l'utilisateur.
Le corps de la requête est invalide ou manquant.
Nom d'utilisateur ou mot de passe incorrect.
Permet à un utilisateur authentifié de changer son mot de passe.
L'ancien mot de passe, le nouveau mot de passe et sa confirmation.
Un message de confirmation si le changement a réussi.
Endpoint privé — requiert un token JWT valide (tout rôle accepté).
Règles de validation :
- L'ancien mot de passe doit être correct
- Le nouveau mot de passe doit contenir au moins 6 caractères
- Le nouveau mot de passe et sa confirmation doivent être identiques
- Le nouveau mot de passe ne peut pas être identique à l'ancien
Exemple de requête :
POST /api/auth/change-password
Authorization: Bearer {token}
{
"currentPassword": "ancien_mot_de_passe",
"newPassword": "nouveau_mot_de_passe",
"confirmPassword": "nouveau_mot_de_passe"
}
Exemple de réponse :
{
"message": "Mot de passe modifié avec succès."
}
Mot de passe modifié avec succès.
Validation échouée — ancien mot de passe incorrect, nouveau invalide ou confirmation non concordante.
Token JWT manquant ou invalide.
Gestion des dépenses budgétaires.
Certains endpoints sont publics, d'autres requièrent le rôle GrandCommis.
Retourne le total global des dépenses pour une année fiscale.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
Le montant total alloué et le montant total dépensé pour l'année fiscale,
tous ministères confondus.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/depense/total/2023-2024
Exemple de réponse :
{
"montantAlloue": 150000000.00,
"montantDepense": 120000000.00
}
Retourne le total global des dépenses.
L'année fiscale est manquante ou invalide.
Aucune dépense trouvée pour cette année fiscale.
Retourne les dépenses par article budgétaire pour un ministère donné.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
L'identifiant du ministère sur 4 chiffres (ex: 1112).
Une liste regroupant les dépenses du ministère par article budgétaire,
avec les montants alloués, engagés et dépensés pour chaque article.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/depense/ministere/2023-2024/1112
Retourne les dépenses groupées par article.
L'année fiscale ou le ministère est manquant.
Aucune dépense trouvée pour ce ministère et cette année fiscale.
Retourne le total des dépenses par article budgétaire pour une année fiscale.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
Une liste des 9 articles budgétaires avec le total des montants
alloués, engagés et dépensés sur l'ensemble des ministères.
Endpoint public — aucune authentification requise.
Les articles budgétaires sont :
- 1 : Dépenses de personnel
- 2 : Services et charges diverses
- 3 : Achats de biens de consommation
- 4 : Immobilisation corporelle
- 5 : Immobilisation incorporelle
- 6 : Prêts, avances et participations
- 7 : Subventions et contributions
- 8 : Amortissement de la dette
- 9 : Autres dépenses publiques
Exemple de requête :
GET /api/depense/article/2023-2024
Retourne les dépenses groupées par article.
L'année fiscale est manquante ou invalide.
Aucune dépense trouvée pour cette année fiscale.
Retourne les dépenses mensuelles par période d'allocation pour une année fiscale.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
Une liste de 13 périodes (Octobre → Septembre + Correction) avec les montants
alloués, engagés et dépensés par mois.
Endpoint public — aucune authentification requise.
L'année fiscale haïtienne commence en Octobre et se termine en Septembre.
La période "Correction" (13e mois) correspond aux ajustements de fin d'exercice.
Exemple de requête :
GET /api/depense/periode/allocation/2023-2024
Retourne les dépenses par période d'allocation.
L'année fiscale est manquante ou invalide.
Aucune dépense trouvée pour cette année fiscale.
Retourne les dépenses par alinéa budgétaire pour un ministère donné.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
L'identifiant du ministère sur 4 chiffres (ex: 1112).
Une liste regroupant les dépenses du ministère par alinéa budgétaire,
avec les montants alloués, engagés et dépensés pour chaque alinéa.
Endpoint privé — requiert le rôle **GrandCommis**.
L'alinéa est le niveau de détail le plus fin de la nomenclature budgétaire,
en dessous de l'article et du paragraphe.
Exemple de requête :
GET /api/depense/ministere/alinea/2023-2024/1112
Retourne les dépenses groupées par alinéa.
L'année fiscale ou le ministère est manquant.
Token d'authentification manquant ou invalide.
L'utilisateur n'a pas le rôle GrandCommis.
Aucune dépense trouvée pour ce ministère et cette année fiscale.
Retourne les dépenses par section et par article pour un ministère donné.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
L'identifiant du ministère sur 4 chiffres (ex: 1112).
Une structure hiérarchique : ministère → sections → articles,
avec les montants alloués, engagés et dépensés à chaque niveau.
Endpoint privé — requiert le rôle **GrandCommis**.
Exemple de requête :
GET /api/depense/ministere/section/2023-2024/1112
Retourne les dépenses groupées par section et article.
L'année fiscale ou le ministère est manquant.
Token d'authentification manquant ou invalide.
L'utilisateur n'a pas le rôle GrandCommis.
Aucune dépense trouvée pour ce ministère et cette année fiscale.
Analyse budgétaire en perspective — évolution sur plusieurs années fiscales.
Certains endpoints sont publics, d'autres requièrent le rôle GrandCommis.
Retourne l'évolution globale du budget sur toutes les années fiscales disponibles.
Un objet contenant le nombre d'années fiscales analysées et la liste
de l'évolution annuelle du budget (alloué, engagé, dépensé) tous
ministères confondus.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/perspective/annee/global
Exemple de réponse :
{
"nombreAnneeFiscale": 3,
"evolutionAnnuelle": [
{
"anneeFiscale": "2021-2022",
"nombreMinistere": 33,
"totalMontantAlloue": 140000000.00,
"totalMontantEngage": 130000000.00,
"totalMontantDepense": 125000000.00
}
]
}
Retourne l'évolution globale du budget.
Aucune donnée budgétaire trouvée.
Retourne l'évolution pluriannuelle du budget pour un article budgétaire donné.
L'identifiant de l'article budgétaire (1 seul caractère, de "1" à "9").
Un objet contenant l'identifiant et la désignation de l'article,
ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé).
Endpoint public — aucune authentification requise.
Les articles budgétaires valides sont :
- "1" : Dépenses de personnel
- "2" : Services et charges diverses
- "3" : Achats de biens de consommation
- "4" : Immobilisation corporelle
- "5" : Immobilisation incorporelle
- "6" : Prêts, avances et participations
- "7" : Subventions et contributions
- "8" : Amortissement de la dette
- "9" : Autres dépenses publiques
Exemple de requête :
GET /api/perspective/article/1
Retourne l'évolution de l'article budgétaire.
L'article est manquant ou invalide (doit être un seul caractère).
Aucune donnée trouvée pour cet article.
Retourne l'évolution pluriannuelle du budget pour un ministère donné.
L'identifiant du ministère sur 4 chiffres (ex: 1112).
Un objet contenant l'identifiant et la désignation du ministère,
ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé).
Endpoint privé — requiert le rôle **GrandCommis**.
Exemple de requête :
GET /api/perspective/annee/1112
Retourne l'évolution annuelle du ministère.
Le ministère est manquant.
Token d'authentification manquant ou invalide.
L'utilisateur n'a pas le rôle GrandCommis.
Aucune donnée trouvée pour ce ministère.
Retourne l'évolution du budget d'un ministère pour une période mensuelle donnée,
sur toutes les années fiscales disponibles.
L'identifiant du ministère sur 4 chiffres (ex: 1112).
La période mensuelle (valeur entière correspondant à l'enum PeriodeFiscale) :
1=Octobre, 2=Novembre, 3=Décembre, 4=Janvier, 5=Février, 6=Mars,
7=Avril, 8=Mai, 9=Juin, 10=Juillet, 11=Août, 12=Septembre, 13=Correction.
Un objet contenant l'identifiant et la désignation du ministère,
ainsi que la liste des montants pour ce mois sur chaque année fiscale.
Endpoint privé — requiert le rôle **GrandCommis**.
Exemple de requête :
GET /api/perspective/periode/1112/4
(Retourne les données du mois de Janvier pour le MEF sur toutes les années)
Retourne l'évolution mensuelle du ministère.
Le ministère est manquant ou la période est invalide.
Token d'authentification manquant ou invalide.
L'utilisateur n'a pas le rôle GrandCommis.
Aucune donnée trouvée pour ce ministère et cette période.
Retourne l'évolution pluriannuelle du budget pour une section administrative donnée.
L'identifiant de la section sur 7 caractères (ex: 1112001).
Un objet contenant l'identifiant et la désignation de la section,
ainsi que la liste de son évolution annuelle (alloué, engagé, dépensé).
Endpoint privé — requiert le rôle **GrandCommis**.
Exemple de requête :
GET /api/perspective/section/1112001
Retourne l'évolution annuelle de la section.
La section est manquante ou n'a pas 7 caractères.
Token d'authentification manquant ou invalide.
L'utilisateur n'a pas le rôle GrandCommis.
Aucune donnée trouvée pour cette section.
Gestion des projets d'investissement public par département géographique.
Tous les endpoints sont publics — aucune authentification requise.
Retourne la liste des projets d'investissement pour un département géographique donné.
Le code du département sur 2 caractères.
Départements disponibles : AR (Artibonite), CE (Centre), GA (Grande-Anse),
ND (Nord), NE (Nord-Est), NO (Nord-Ouest), OU (Ouest), SD (Sud),
SE (Sud-Est), NI (Nippes).
Un objet contenant les informations du département (identifiant, sigle, désignation),
le nombre total de projets, et la liste détaillée de chaque projet avec
son programme, sa commune, ses coordonnées GPS et son financement.
Endpoint public — aucune authentification requise.
Chaque projet retourné inclut :
- Le programme auquel il appartient
- La commune d'exécution
- Les coordonnées GPS (latitude/longitude) si disponibles
- Le financement (montant alloué, montant autorisé, bailleur)
Exemple de requête :
GET /api/projet/departement/OU
Exemple de réponse :
{
"departementId": "OU",
"departementSigle": "OU",
"departementDesignation": "OUEST",
"nombreProjets": 12,
"projets": [
{
"projetId": "PRJ-001",
"projetDesignation": "Construction école nationale",
"anneeFiscale": "2023-2024",
"programme": { "id": "111200001", "designation": "Programme Éducation" },
"commune": { "id": "0101", "designation": "Port-au-Prince" },
"latitude": "18.5392",
"longitude": "-72.3288",
"financement": {
"montantAlloue": 5000000.00,
"montantAutorise": 4800000.00,
"bailleur": {
"id": "BM",
"designation": "Banque Mondiale",
"type": "International",
"typeFinancement": "Don"
}
}
}
]
}
Retourne la liste des projets du département.
Le code département est manquant ou n'a pas 2 caractères.
Aucun projet trouvé pour ce département.
Gestion des données de référence (années fiscales, ministères).
Tous les endpoints sont publics — aucune authentification requise.
Retourne la liste de toutes les années fiscales disponibles.
Une liste d'années fiscales avec leur libellé et un indicateur
précisant laquelle est l'année courante.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/referentiel/annees-fiscales
Exemple de réponse :
[
{
"anneeFiscale": "2023-2024",
"labelFiscale": "Exercice 2023-2024",
"isCurrent": true
}
]
Retourne la liste des années fiscales.
Aucune année fiscale trouvée en base de données.
Retourne la liste des ministères actifs pour une année fiscale donnée.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
Une liste de ministères avec leur identifiant et leur désignation.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/referentiel/ministeres/2023-2024
Exemple de réponse :
[
{
"id": "1112",
"designation": "MINISTÈRE DE L'ÉCONOMIE ET DES FINANCES"
}
]
Retourne la liste des ministères.
L'année fiscale est manquante ou invalide.
Aucun ministère trouvé pour cette année fiscale.
Retourne le nombre total de ministères pour une année fiscale donnée.
L'année fiscale au format "AAAA-AAAA" (ex: 2023-2024).
Un objet contenant le nombre total de ministères actifs.
Endpoint public — aucune authentification requise.
Exemple de requête :
GET /api/referentiel/nombres/ministere/2023-2024
Exemple de réponse :
{
"totalMinistere": 33
}
Retourne le nombre total de ministères.
L'année fiscale est manquante ou invalide.
Aucun ministère trouvé pour cette année fiscale.
Modèle pour le changement de mot de passe d'un utilisateur authentifié.
Mot de passe actuel de l'utilisateur.
Nouveau mot de passe souhaité.
Confirmation du nouveau mot de passe — doit être identique à NewPassword.
Retourne l'année fiscale en cours au format "YYYY-YYYY"
Exemple : "2024-2025" si nous sommes en octobre 2024
Contrat pour l'accès aux données de dépenses budgétaires.
Regroupe les méthodes publiques et privées liées aux dépenses.
Retourne le total global des dépenses pour une année fiscale.
Retourne les dépenses par article budgétaire pour un ministère donné.
Retourne le total des dépenses par article budgétaire pour une année fiscale,
tous ministères confondus.
Retourne les dépenses mensuelles par période d'allocation pour une année fiscale.
Retourne les dépenses par alinéa budgétaire pour un ministère donné.
Accès restreint au rôle GrandCommis.
Retourne les dépenses par section et par article pour un ministère donné.
Accès restreint au rôle GrandCommis.
Contrat pour l'accès aux données d'analyse budgétaire en perspective —
évolution pluriannuelle du budget.
Regroupe les méthodes publiques et privées liées aux perspectives.
Retourne l'évolution globale du budget sur toutes les années fiscales,
tous ministères confondus.
Retourne l'évolution pluriannuelle du budget pour un article budgétaire donné.
Retourne l'évolution pluriannuelle du budget pour un ministère donné.
Accès restreint au rôle GrandCommis.
Retourne l'évolution du budget d'un ministère pour une période mensuelle donnée,
sur toutes les années fiscales disponibles.
Accès restreint au rôle GrandCommis.
Retourne l'évolution pluriannuelle du budget pour une section administrative donnée.
Accès restreint au rôle GrandCommis.
Contrat pour l'accès aux données des projets d'investissement public.
Retourne la liste des projets d'investissement pour un département géographique donné,
avec les détails de financement et les coordonnées GPS de chaque projet.
Contrat pour l'accès aux données de référence :
années fiscales, ministères et leurs totaux.
Retourne la liste de toutes les années fiscales disponibles.
Retourne la liste des ministères actifs pour une année fiscale donnée.
Retourne le nombre total de ministères pour une année fiscale donnée.