get
/api/v1/businessProfil entreprise
Odgovori
- 200OK
Hitri začetek
Ustvarite API ključ v nastavitvah svojega računa, nato pokličite API z glavo X-Api-Key.
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 }
]
}'Avtentikacija
Vsaka zahteva mora vključevati vaš API ključ, bodisi v glavi X-Api-Key bodisi kot žeton Bearer. Obe metodi sta enakovredni.
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"
Končne točke
Podjetje
put
/api/v1/businessMise à jour du profil
Odgovori
- 200OK
Stranke
get
/api/v1/clientsListe des clients
Parametri
pagequery | integer | |
qquery | string | Recherche nom/email/téléphone |
Odgovori
- 200OK
post
/api/v1/clientsCréation client
Odgovori
- 201Créé
get
/api/v1/clients/{id}Détail client
Odgovori
- 200OK
- 404Introuvable
put
/api/v1/clients/{id}Édition client
Odgovori
- 200OK
delete
/api/v1/clients/{id}Archivage client (pas de suppression définitive)
Odgovori
- 200OK
Računi
get
/api/v1/invoicesListe des factures
Parametri
pagequery | integer | |
statusquery | string |
Odgovori
- 200OK
post
/api/v1/invoicesCréation facture (avec lignes)
Telo zahteve
| Polje | Tip | Opis |
|---|---|---|
client_idobvezno | uuid | |
currencyobvezno | string | |
due_date | string | null | |
notes | string | null | |
linesobvezno | InvoiceLine[] |
Odgovori
- 201Créée
get
/api/v1/invoices/{id}Détail facture + lignes + événements
Odgovori
- 200OK
get
/api/v1/invoices/{id}/pdfPDF de la facture
Odgovori
- 200application/pdf
post
/api/v1/invoices/{id}/sendEnvoi (email / sms / lien), mode normal ou rappel
Telo zahteve
| Polje | Tip | Opis |
|---|---|---|
channelsobvezno | string[] | |
reminder | boolean |
Odgovori
- 200OK (sandbox: envoi simulé)
get
/api/v1/invoices/{id}/eventsTimeline d'événements
Odgovori
- 200OK
Sheme
Struktura objektov, ki jih sprejema in vrača API.
Client
| Polje | Tip | Opis |
|---|---|---|
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
| Polje | Tip | Opis |
|---|---|---|
descriptionobvezno | string | |
quantityobvezno | number | |
unit_price_centsobvezno | integer | Centimes |
tax_rateobvezno | number | Pourcentage (ex. 20) |
Invoice
| Polje | Tip | Opis |
|---|---|---|
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 |