Authentifier vos appels
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.
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.