API REST di Frihet
Accesso programmatico a fatture, clienti, spese, prodotti e preventivi. Progettata per integrazioni che scalano.
Fatta per gli sviluppatori
Aggiornamenti parziali PATCH
Aggiorna solo i campi di cui hai bisogno. Schemi parziali validati con Zod garantiscono l'integrità.
Ricerca e filtri
Ricerca full-text con parametro ?q=. Mappatura dei campi per risorsa per risultati precisi.
Operazioni batch
Crea fino a 50 risorse in una singola richiesta. Risposte HTTP 207 multi-status.
Chiavi di idempotenza
Riprova le richieste in modo sicuro con l'header Idempotency-Key. Le chiavi vengono riconosciute per 24 ore.
Header di limite di frequenza
X-RateLimit-Limit, Remaining e Reset in ogni risposta. Pianifica di conseguenza.
Spec OpenAPI 3.1
Specificazione leggibile dalle macchine in /openapi.yaml. 16 percorsi, 18 schemi. Genera SDK automaticamente.
Endpoint di intelligenza
Contesto di business, riepiloghi mensili e dati fiscali trimestrali via /context, /monthly, /quarterly.
Eliminazione sicura VeriFactu
Soft delete per fatture e preventivi non in bozza. Tracciabilità completa per la conformità fiscale spagnola.
Endpoint
| Method | Path |
|---|---|
| GET | /v1/invoices |
| POST | /v1/invoices |
| PATCH | /v1/invoices/:id |
| DELETE | /v1/invoices/:id |
| POST | /v1/invoices/batch |
| GET | /v1/clients |
| POST | /v1/clients |
| GET | /v1/expenses |
| POST | /v1/expenses |
| GET | /v1/products |
| GET | /v1/quotes |
| GET | /v1/context |
| GET | /v1/monthly |
| GET | /v1/quarterly |
| GET | /openapi.yaml |
Esempi di codice
import { Frihet } from '@frihet/sdk';
const apiKey = process.env.FRIHET_API_KEY;
if (!apiKey) throw new Error('Set FRIHET_API_KEY before running this example');
const frihet = new Frihet({ apiKey });
// Follow each page's nextCursor until all paid invoices have been read.
let cursor: string | undefined;
do {
const page = await frihet.invoices.list({ status: 'paid', limit: 25, cursor });
for (const invoice of page.data) {
console.log(invoice.documentNumber, invoice.total);
}
cursor = page.nextCursor;
} while (cursor);
Autenticazione
Genera chiavi API da Impostazioni > API nel tuo pannello Frihet. Includi la tua chiave come Bearer token nell'header Authorization.
Authorization: Bearer fri_...
Inizia a integrare oggi
Accesso all'API incluso in tutti i piani. La tua chiave API è pronta in Impostazioni.
Inizia Gratis