Documentation API
Intégrez la conversion Factur-X à vos applications
Démarrage rapide
1. Authentification
Connectez-vous pour obtenir votre token JWT :
POST https://api.pont-facturx.com/v1/auth/login
Content-Type: application/json
{
"email": "votre@email.com",
"password": "votre_mot_de_passe"
}2. Upload et conversion
Envoyez votre PDF pour extraction OCR :
POST https://api.pont-facturx.com/v1/invoices/upload
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: multipart/form-data
file: @facture.pdf3. Génération Factur-X
Générez le fichier Factur-X final :
POST https://api.pont-facturx.com/v1/invoices/generate
Authorization: Bearer YOUR_JWT_TOKEN
Content-Type: application/json
{
"invoice_id": "abc123",
"final_json": {...}
}Authentification JWT
Tokens sécurisés avec expiration de 30 minutes. Rafraîchissement automatique supporté.
Rate Limiting
100 requêtes/minute en production. Headers X-RateLimit inclus dans toutes les réponses.
Format JSON
Toutes les réponses sont en JSON. Structure conforme à EN16931.
Webhooks (bientôt)
Notifications en temps réel pour les conversions terminées.
Codes d'erreur
400Requête invalide (données manquantes ou mal formées)401Non authentifié (token manquant ou expiré)403Accès refusé (crédits insuffisants)429Trop de requêtes (rate limit dépassé)500Erreur serveur (réessayez plus tard)