/api/v1/businessProfil entreprise
Réponses
- 200OK
Intégrez la facturation FastFaktura dans vos outils : clients, factures, envois et PDF via une API REST simple. Les comptes sandbox simulent les envois réels et utilisent Stripe en mode test.
https://app.fastfaktura.io/api/v1Générez une clé API depuis les paramètres de votre compte, puis appelez l'API avec l'en-tête X-Api-Key.
curl -X POST https://app.fastfaktura.io/api/v1/invoices \
-H "X-Api-Key: ffk_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"client_id": "1f0c4a9e-…",
"currency": "EUR",
"lines": [
{ "description": "Consulting", "quantity": 1, "unit_price_cents": 50000, "tax_rate": 20 }
]
}'Chaque requête doit inclure votre clé API, soit dans l'en-tête X-Api-Key, soit en Bearer token. Les deux méthodes sont équivalentes.
curl https://app.fastfaktura.io/api/v1/clients \ -H "X-Api-Key: ffk_xxxxxxxx"
curl https://app.fastfaktura.io/api/v1/clients \ -H "Authorization: Bearer ffk_xxxxxxxx"
/api/v1/businessProfil entreprise
/api/v1/businessMise à jour du profil
/api/v1/clientsListe des clients
pagequery | integer | |
qquery | string | Recherche nom/email/téléphone |
/api/v1/clientsCréation client
/api/v1/clients/{id}Détail client
/api/v1/clients/{id}Édition client
/api/v1/clients/{id}Archivage client (pas de suppression définitive)
/api/v1/invoicesListe des factures
pagequery | integer | |
statusquery | string |
/api/v1/invoicesCréation facture (avec lignes)
| Champ | Type | Description |
|---|---|---|
client_idrequis | uuid | |
currencyrequis | string | |
due_date | string | null | |
notes | string | null | |
linesrequis | InvoiceLine[] |
/api/v1/invoices/{id}Détail facture + lignes + événements
/api/v1/invoices/{id}/pdfPDF de la facture
/api/v1/invoices/{id}/sendEnvoi (email / sms / lien), mode normal ou rappel
| Champ | Type | Description |
|---|---|---|
channelsrequis | string[] | |
reminder | boolean |
/api/v1/invoices/{id}/eventsTimeline d'événements
Structure des objets acceptés et retournés par l'API.
| Champ | Type | Description |
|---|---|---|
id | uuid | |
name | string | |
email | string | null | |
phone | string | null | E.164 |
address | string | null | |
country | string | null | |
locale | string | frennbsv |
external_id | string | null | |
tags | string[] | |
archived_at | string | null |
| Champ | Type | Description |
|---|---|---|
descriptionrequis | string | |
quantityrequis | number | |
unit_price_centsrequis | integer | Centimes |
tax_raterequis | number | Pourcentage (ex. 20) |
| Champ | Type | Description |
|---|---|---|
id | uuid | |
number | string | |
client_id | uuid | |
currency | string | EURUSDGBPNOKSEKDKK |
subtotal_cents | integer | |
tax_cents | integer | |
total_cents | integer | |
status | string | draftsentopenedpaidoverduecancelled |
due_date | string | null | |
public_url | string |