Documentation API

Intégrez la conversion PDF → Factur-X dans vos applications, ERP et logiciels comptables.

API réservée aux abonnements Pro et Business. Chaque conversion consomme 1 crédit.

Accès réservé Pro & Business

Pour utiliser l'API, votre compte doit disposer d'un abonnement Pro ou Business actif. Les comptes Starter peuvent accéder à l'interface web, mais pas à l'API. Gérez vos clés API depuis Réglages → API.

Démarrage rapide

1. Obtenir une clé API

Depuis votre espace client, allez dans Réglages → API et créez une clé. Elle est affichée une seule fois — conservez-la précieusement.

# Format de votre clé API
sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. Vérifier vos crédits disponibles

Avant de convertir, vérifiez votre solde de crédits et le statut de votre compte.

curl https://www.pont-facturx.com/v1/account/usage \
  -H "Authorization: Bearer sk_live_..."

{
  "plan": "Abonnement Pro",
  "subscription_status": "active",
  "credits_available": 187,
  "free_remaining": 0,
  "subscription_remaining": 187,
  "paid_credits": 0,
  "rate_limit": "30 requests/minute"
}

3. Convertir un PDF en Factur-X

Un seul appel suffit. L'OCR est lancé automatiquement si vous n'envoyez pas invoice_data.

curl -X POST https://www.pont-facturx.com/v1/convert \
  -H "Authorization: Bearer sk_live_..." \
  -F "file=@facture.pdf" \
  -F "profile=BASIC_WL" \
  --output facture_facturx.pdf

Paramètre	Type	Description
file	multipart *requis	Fichier PDF à convertir
profile	string	MINIMUM, BASIC_WL (défaut), EN16931, COMFORT
invoice_data	JSON string	Données de la facture — si absent, OCR automatique

Référence des endpoints

Tous les endpoints utilisent le même header d'authentification :
Authorization: Bearer sk_live_...

Conversion

POST/v1/extract0 crédit

OCR seulement — retourne le JSON extrait du PDF (invoice_data + raw). Utile pour vérifier/corriger avant de convertir. Ne consomme pas de crédit.

POST/v1/convert1 crédit

PDF → Factur-X. Retourne directement le PDF final en application/pdf. Passe invoice_data pour sauter l'OCR.

Historique

GET/v1/conversions

Liste vos 500 dernières conversions triées par date décroissante.

GET/v1/conversions/{id}

Détail d'une conversion spécifique par ID (statut, fichier, montant, SIRET…).

GET/v1/conversions/{id}/download/{kind}

Télécharge le fichier d'une conversion. kind : pdf (Factur-X) ou xml (CII brut).

Transmission Chorus Pro / PDP

POST/v1/conversions/{id}/send-pdp

Transmet la facture au PDP (Chorus Pro). Body JSON avec destination et recipient_siret.

GET/v1/conversions/{id}/pdp-status

Statut de la transmission PDP. Ajoutez ?sync=true pour forcer une synchronisation en temps réel avec Chorus Pro.

Compte

GET/v1/account/usage

Plan actif, crédits disponibles (free / abonnement / payés) et limite de taux.

GET/v1/auth/api-keys

Liste vos clés API actives (préfixe, date de création, dernière utilisation).

DELETE/v1/auth/api-keys/{id}

Révoque une clé API. Action immédiate et irréversible. Retourne 204 No Content.

Clés API sécurisées

Créez jusqu'à 5 clés révocables depuis votre dashboard. Chaque clé est préfixée sk_live_ et stockée hashée — visible une seule fois à la création.

Rate Limiting

30 requêtes/minute sur /v1/convert. En cas de dépassement, l'API retourne un 429 avec un header Retry-After.

Historique accessible

Listez et re-téléchargez vos conversions passées via /v1/conversions — PDF Factur-X ou XML CII brut.

Webhooks (bientôt)

Notifications en temps réel pour les conversions terminées.

Codes d'erreur

401

Clé API invalide ou manquante

{"code": "invalid_api_key", "message": "Clé API invalide ou révoquée."}

402

Crédits épuisés

{"code": "no_credits", "message": "Aucun crédit disponible. Rechargez votre compte."}

403

Abonnement inactif ou plan insuffisant

{"code": "premium_required", "message": "L'accès API est réservé aux abonnements Pro et Business."}

429

Rate limit dépassé

Header Retry-After inclus dans la réponse.

500

Erreur serveur

Réessayez ou contactez le support.

Besoin d'aide pour votre intégration ?

Notre équipe est là pour vous accompagner