get
/api/v1/businessProfil entreprise
Svar
- 200OK
Hurtig start
Generer en API-nøgle fra dine kontoindstillinger, og kald derefter API'et med X-Api-Key-headeren.
curl
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 }
]
}'Godkendelse
Hver anmodning skal indeholde din API-nøgle, enten i X-Api-Key-headeren eller som et Bearer-token. Begge metoder er ækvivalente.
X-Api-Key
curl https://app.fastfaktura.io/api/v1/clients \ -H "X-Api-Key: ffk_xxxxxxxx"
Authorization: Bearer
curl https://app.fastfaktura.io/api/v1/clients \ -H "Authorization: Bearer ffk_xxxxxxxx"
Endpoints
Virksomhed
put
/api/v1/businessMise à jour du profil
Svar
- 200OK
Kunder
get
/api/v1/clientsListe des clients
Parametre
pagequery | integer | |
qquery | string | Recherche nom/email/téléphone |
Svar
- 200OK
post
/api/v1/clientsCréation client
Svar
- 201Créé
get
/api/v1/clients/{id}Détail client
Svar
- 200OK
- 404Introuvable
put
/api/v1/clients/{id}Édition client
Svar
- 200OK
delete
/api/v1/clients/{id}Archivage client (pas de suppression définitive)
Svar
- 200OK
Fakturaer
get
/api/v1/invoicesListe des factures
Parametre
pagequery | integer | |
statusquery | string |
Svar
- 200OK
post
/api/v1/invoicesCréation facture (avec lignes)
Anmodningsindhold
| Felt | Type | Beskrivelse |
|---|---|---|
client_idpåkrævet | uuid | |
currencypåkrævet | string | |
due_date | string | null | |
notes | string | null | |
linespåkrævet | InvoiceLine[] |
Svar
- 201Créée
get
/api/v1/invoices/{id}Détail facture + lignes + événements
Svar
- 200OK
get
/api/v1/invoices/{id}/pdfPDF de la facture
Svar
- 200application/pdf
post
/api/v1/invoices/{id}/sendEnvoi (email / sms / lien), mode normal ou rappel
Anmodningsindhold
| Felt | Type | Beskrivelse |
|---|---|---|
channelspåkrævet | string[] | |
reminder | boolean |
Svar
- 200OK (sandbox: envoi simulé)
get
/api/v1/invoices/{id}/eventsTimeline d'événements
Svar
- 200OK
Skemaer
Struktur for de objekter, der accepteres og returneres af API'et.
Client
| Felt | Type | Beskrivelse |
|---|---|---|
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 |
InvoiceLine
| Felt | Type | Beskrivelse |
|---|---|---|
descriptionpåkrævet | string | |
quantitypåkrævet | number | |
unit_price_centspåkrævet | integer | Centimes |
tax_ratepåkrævet | number | Pourcentage (ex. 20) |
Invoice
| Felt | Type | Beskrivelse |
|---|---|---|
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 |