API REST compl\u00e8te

Int\u00e9grez FrenchInvoice directement dans vos outils, vos scripts et vos workflows. Cr\u00e9ez des factures, g\u00e9rez vos clients et t\u00e9l\u00e9chargez vos PDF Factur-X depuis n'importe quel langage de programmation.

Endpoints principaux

GET/api/clients

Lister les clients

POST/api/clients

Créer un client

GET/api/invoices

Lister les factures (filtres: status, from, to)

POST/api/invoices

Créer une facture

GET/api/invoices/{id}/pdf

Télécharger le PDF

PUT/api/invoices/{id}/status

Changer le statut

GET/api/quotes

Lister les devis

POST/api/quotes/{id}/convert

Convertir devis → facture

Exemple d'utilisation

terminal
curl -H "Authorization: Bearer <votre-clé>" \
     https://api.frenchinvoice.fr/api/invoices
r\u00e9ponse JSON
{
  "id": 42,
  "numero": "FAC-2026-0012",
  "status": "envoyee",
  "dateEmission": "2026-04-15T00:00:00",
  "clientNom": "Dupont SARL",
  "totalHt": 1500.00,
  "totalTtc": 1500.00,
  "mentionTva": "TVA non applicable, art. 293B du CGI"
}

Authentification sécurisée

Chaque requête est protégée par un token Bearer. Votre clé API est définie dans le fichier .env et vérifiée par un middleware dédié sur toutes les routes /api/*. Aucune donnée n'est accessible sans authentification.

Authorization: Bearer ****-****-****

Sérialisation JSON standard

Toutes les réponses suivent les conventions modernes : camelCase pour les propriétés, dates au format ISO 8601, enums sérialisés en chaînes lisibles. Intégration immédiate avec n'importe quel client HTTP.

"dateEmission": "2026-04-15T00:00:00",
"status": "envoyee",
"totalHt": 1500.00

Rate limiting intégré

60 requêtes par minute par adresse IP. Protection automatique contre les abus et les scripts mal configurés. Réponse HTTP 429 avec en-tête Retry-After en cas de dépassement.

60 req/min

Intégration avec vos outils

Connectez FrenchInvoice à Zapier, n8n, Make ou vos scripts personnalisés. Automatisez la création de factures, l'export de données et le suivi des paiements.

Zapier
n8n
Make
Scripts
FrenchInvoice

Pr\u00eat \u00e0 int\u00e9grer ?

D\u00e9couvrez comment l'API REST de FrenchInvoice peut automatiser votre facturation et s'int\u00e9grer \u00e0 vos outils existants.