URL de base
https://api.fineeduc.comDéveloppeurs
L’API REST Fineduc.
La même API que notre propre tableau de bord utilise. Rien de séparé, rien de bridé : ce que l’application fait, vous pouvez le faire.
Authentification
Chaque appel porte un jeton JWT dans l’en-tête Authorization. Vous l’obtenez en vous connectant avec le compte de votre école ; il est lié à cet établissement et ne donne accès à rien d’autre.
Authorization: Bearer <access_token>Essayer une requête
Ces appels partent vers l’API de production, depuis votre navigateur. Rien ne transite par nos serveurs web.
Gardé en mémoire uniquement, jamais enregistré. Fermez l’onglet et il disparaît.
Obtenir un jeton
Remplacez :id et les autres paramètres par de vraies valeurs.
Réponse
Aucune requête envoyée.
Points d’entrée
Authentification
- POST
/auth/login-schoolOuvre une session école et renvoie les jetons. - POST
/auth/refreshÉchange un refresh token contre un nouvel accès. - GET
/auth/meL’utilisateur courant et son rôle. - POST
/auth/logoutRévoque la session.
Élèves
- GET
/studentsListe paginée et filtrable. - GET
/students/:idLe dossier complet d’un élève. - POST
/students/:id/enrollInscrit l’élève et génère son échéancier. - GET
/students/:id/guardiansLes parents payeurs rattachés.
Facturation
- GET
/fee-schedulesLes grilles tarifaires. - POST
/fee-schedules/:id/publishPublie une version — elle devient immuable. - GET
/invoices/:idUne facture et ses tranches. - GET
/invoices/:studentId/statementLe relevé d’un élève : dû, payé, restant.
Caisse
- POST
/cash-sessionsOuvre une caisse avec un fonds de départ. - POST
/cash-sessions/paymentsEncaisse un paiement en espèces. - GET
/cash-sessions/:id/expectedLe montant attendu en caisse à cet instant. - POST
/cash-sessions/:id/closeClôture avec comptage ; tout écart exige un motif.
Paiement en ligne
- GET
/pay/:tokenLa page parent, publique, sans session. - POST
/pay/:token/initiateDémarre un paiement mobile money ou carte.
Moratoires
- GET
/moratoire/:tokenLa demande de délai, côté parent. - POST
/moratoriums/:id/approveAccorde le délai et replanifie les tranches. - POST
/moratoriums/:id/refuseRefuse la demande, avec motif.
Abonnement
- GET
/tenant/subscriptionLe plan, l’échéance et le temps restant. - POST
/tenant/subscription/checkoutOuvre un paiement de renouvellement.
Service
- GET
/healthSonde de disponibilité. - GET
/health/readyBase de données et Redis joignables.
Erreurs
Toutes les erreurs suivent la norme RFC 9457 (application/problem+json). Le champ code est stable et destiné à votre code ; detail est écrit pour un humain et peut être reformulé.
{
"type": ".../errors/HTTP_402",
"title": "PaymentRequired",
"status": 402,
"code": "SUBSCRIPTION_LAPSED",
"detail": "…",
"traceId": "…"
}Limites de débit
Par minute et par IP : 10 sur les routes d’authentification, 30 sur les pages publiques de paiement, 120 sur les webhooks. Un dépassement renvoie 429 avec les en-têtes RateLimit standard.
Clés d’API : pas encore
Il n’existe pas encore de clé d’API permettant à un service tiers d’appeler Fineduc sans session. L’authentification se fait uniquement par jeton utilisateur. Nous préférons le dire plutôt que documenter une fonctionnalité que vous ne pourriez pas utiliser.
Prêt à récupérer ce que votre école perd chaque année ?
Envoyez votre demande en 2 minutes. Notre équipe la valide sous 24 heures et vous envoie vos accès — puis 7 jours d’essai gratuit.