Vue d'ensemble de l'API
API REST JSON — authentification par JWT Bearer token.
Authentification
Toutes les requêtes doivent inclure un token JWT dans l'en-tête Authorization. Obtenez votre token depuis Paramètres → API → Générer un token.
curl https://api.factpilot.fr/api/v1/invoices \ -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \ -H "Content-Type: application/json"
Les tokens ont une durée de validité de 90 jours. Renouvelez-les avant expiration depuis vos paramètres.
URL de base
Toutes les requêtes API utilisent l'URL de base : https://api.factpilot.fr
Endpoints
| Méthode | Endpoint | Description |
|---|---|---|
| GET | /api/v1/invoices | Lister les factures |
| POST | /api/v1/invoices | Créer / importer une facture |
| GET | /api/v1/invoices/{id} | Détail d'une facture |
| PATCH | /api/v1/invoices/{id} | Mettre à jour une facture |
| DELETE | /api/v1/invoices/{id} | Supprimer une facture |
| POST | /api/v1/fec/export | Générer l'export FEC |
| GET | /api/v1/reconciliation | Lister les rapprochements |
Codes d'erreur
| Code | Signification |
|---|---|
401 | Token manquant ou expiré |
403 | Accès non autorisé à cette ressource |
404 | Ressource introuvable |
422 | Données invalides (voir le champ errors) |
429 | Limite de requêtes atteinte (100 req/min) |
500 | Erreur serveur interne |