FFakturBi Documentation

Authentifier vos appels

Mise à jour : novembre 20265 min de lectureAPI v1

Chaque appel porte une clé. La clé dit qui vous êtes, ce que vous pouvez faire et pour quelles entreprises.

1. Envoyer la clé

Placez la clé dans l'en-tête Authorization. Sans clé valide, la réponse est 401.

curl "$EINVOICING_API_BASE_URL/invoices/F-2026-000143" \
  -H "Authorization: Bearer $EINVOICING_API_KEY"

2. Ce que la clé autorise

Chaque opération demande un droit précis. Une clé sans ce droit reçoit 403 ; une adresse qui n'existe pas reçoit 404.

DroitOpérations
invoices:readLire une facture ou un avoir, l'aperçu, la recherche
invoices:writeCréer un brouillon de facture
drafts:editModifier un brouillon
credit_notes:writeCréer un brouillon d'avoir
test:finalizeFinaliser un document d'essai (clé d'essai seulement)

3. Les entreprises de la clé

Une clé est rattachée à une ou plusieurs entreprises émettrices. Chaque création indique issuerId ; sans lui, la réponse est FISC-ISSUER-REQUIRED (400).

Le document d'une entreprise hors de votre clé répond exactement comme un document qui n'existe pas (404). Rien ne révèle son existence.

4. Garder la clé secrète

La clé ne s'affiche qu'une fois, à sa création dans FakturBi. Ne la placez jamais dans une application mobile ou une page web : elle reste sur votre serveur.

Une clé exposée se révoque d'un clic ; son effet est immédiat. Pour la remplacer sans interruption, voir la rotation des clés.

Cette page vous a-t-elle aidé ? Oui · Non