Interface de programmation (API v1)
Pour les logiciels des administrations (état civil, greffes, transports…) : vérifier, réserver et consommer un timbre depuis votre propre application.
Authentification
Chaque partenaire reçoit une clé API rattachée à son administration, avec des droits précis et un quota journalier. La clé se transmet dans l'en-tête Authorization: Bearer <clé>. Toutes les réponses sont en JSON ; les erreurs portent un code stable.
curl -H "Authorization: Bearer ETCC-DEMO-2026-ETATCIVIL-CONNECT-0001" \
"https://e-timbre.infinitydigitalgabon.tech/api/v1/timbres/verifier?numero=TFE-GA-2026-00000001-X"Points d'entrée
| Méthode | Chemin | Droit requis | Fonction |
|---|---|---|---|
| GET | /timbres/verifier?numero=… | verifier | Authenticité, état, type, valeur faciale. Ne consomme jamais. |
| GET | /timbres/{numero} | statut | État courant et historique des transitions. |
| POST | /timbres/reserver | reserver | Réserve le timbre pour un dossier (corps : numero, dossier, dureeMinutes). |
| POST | /timbres/liberer | liberer | Libère une réservation détenue par votre administration. |
| POST | /timbres/consommer | consommer | Consommation définitive (corps : numero, dossier, categorieAttendue). |
| GET | /catalogue | catalogue | Catégories et tarifs en vigueur autorisés pour votre administration. |
| GET | /evenements?depuis=… | evenements | Événements concernant vos timbres (réservation, consommation, annulation). |
| POST | /evenements/webhook-test | evenements | Envoie un événement de test vers votre URL de webhook. |
Exemple : intégration dans un logiciel d'état civil
- L'usager saisit le numéro de son timbre dans votre logiciel, ou votre agent scanne le QR code.
- Votre logiciel appelle
verifieret affiche l'état. S'il est disponible et du bon type, il appellereserveravec la référence du dossier. - À la délivrance de l'acte, votre logiciel appelle
consommer. Le timbre devient définitivement inutilisable. En cas d'abandon,liberer.
POST https://e-timbre.infinitydigitalgabon.tech/api/v1/timbres/consommer
Authorization: Bearer <clé>
Content-Type: application/json
{ "numero": "TFE-GA-2026-00000001-X", "dossier": "NAISS-2026-00123", "categorieAttendue": "EC-001" }
→ 200 { "ok": true, "timbre": { "numeroSerie": "…", "etat": "CONSOMME", "consommeLe": "…" } }
→ 409 { "ok": false, "code": "ETAT_CONSOMME", "message": "Ce timbre a déjà été consommé le …" }Webhooks
Si une URL de webhook est configurée pour votre clé, la plateforme vous notifie chaque événement (timbre.reserve, timbre.consomme, timbre.libere, timbre.annule) par une requête POST signée (en-tête X-Signature, HMAC-SHA256 du corps avec votre secret). Les envois échoués sont réessayés.