v0.1.0OpenAPI 3.1

Documentation API

API REST de conversion de factures PDF vers Factur-X et UBL conformes EN 16931. Authentification par clé API, réponses JSON, erreurs RFC 7807.

openapi.jsonBase URL: https://getfacturio.com/api

Démarrage rapide

Convertissez votre première facture en 3 requêtes.

# 1. Convertir une facture
curl -X POST https://getfacturio.com/api/v1/convert \
  -H "X-API-Key: fio_live_votre_cle" \
  -F "file=@facture.pdf" \
  -F "format=facturx_en16931"

# 2. Vérifier le statut (polling toutes les 2s)
curl https://getfacturio.com/api/v1/status/{id} \
  -H "X-API-Key: fio_live_votre_cle"

# 3. Télécharger le résultat
curl -O https://getfacturio.com/api/v1/convert/{id}/download \
  -H "X-API-Key: fio_live_votre_cle"

Authentification

Deux méthodes sont acceptées sur tous les endpoints /v1/* :

Clé API

Header X-API-Key: fio_live_xxx

Recommandé pour les intégrations programmatiques

Cookie de session

Cookie better-auth.session_token

Utilisé automatiquement par l'application web

Rate limiting

Plan	Requêtes/min	Conversions/mois	Clés API
Free	10	5	0
Pro	30	100	1
Business	60	500	5
Enterprise	120	Illimité	20

Chaque réponse inclut les headers X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. En cas de dépassement (429), le header Retry-After indique le délai d'attente.

Format des erreurs

Toutes les erreurs suivent le standard RFC 7807 — Problem Details for HTTP APIs.

{
  "success": false,
  "error": {
    "type": "https://api.getfacturio.com/errors/quota-exceeded",
    "title": "Quota de conversions dépassé",
    "status": 429,
    "detail": "Vous avez atteint votre limite de 5 conversions/mois.",
    "instance": "/api/v1/convert"
  }
}

Endpoints

Formats de sortie

Valeur	Format	Description
facturx_minimum	Factur-X MINIMUM	Métadonnées essentielles uniquement
facturx_basic_wl	Factur-X BASIC WL	Sans lignes de facture
facturx_basic	Factur-X BASIC	Avec lignes de facture
facturx_en16931	Factur-X EN16931	Profil recommandé — conforme norme européenne
facturx_extended	Factur-X EXTENDED	Tous les champs disponibles
ubl	UBL 2.1	Conforme Peppol BIS 3.0

Besoin d'aide ? Contactez-nous ou consultez la spécification OpenAPI.

Démarrage rapide

Convertissez votre première facture en 3 requêtes.

# 1. Convertir une facture
curl -X POST https://getfacturio.com/api/v1/convert \
  -H "X-API-Key: fio_live_votre_cle" \
  -F "file=@facture.pdf" \
  -F "format=facturx_en16931"

# 2. Vérifier le statut (polling toutes les 2s)
curl https://getfacturio.com/api/v1/status/{id} \
  -H "X-API-Key: fio_live_votre_cle"

# 3. Télécharger le résultat
curl -O https://getfacturio.com/api/v1/convert/{id}/download \
  -H "X-API-Key: fio_live_votre_cle"

Plan

Requêtes/min

Conversions/mois

Clés API

Free

Pro

100

Business

500

Enterprise

120

Illimité

Format des erreurs

{
  "success": false,
  "error": {
    "type": "https://api.getfacturio.com/errors/quota-exceeded",
    "title": "Quota de conversions dépassé",
    "status": 429,
    "detail": "Vous avez atteint votre limite de 5 conversions/mois.",
    "instance": "/api/v1/convert"
  }
}

Formats de sortie

Valeur	Format	Description
facturx_minimum	Factur-X MINIMUM	Métadonnées essentielles uniquement
facturx_basic_wl	Factur-X BASIC WL	Sans lignes de facture
facturx_basic	Factur-X BASIC	Avec lignes de facture
facturx_en16931	Factur-X EN16931	Profil recommandé — conforme norme européenne
facturx_extended	Factur-X EXTENDED	Tous les champs disponibles
ubl	UBL 2.1	Conforme Peppol BIS 3.0