Salta al contenuto

API REST di Frihet

Accesso programmatico a fatture, clienti, spese, prodotti e preventivi. Progettata per integrazioni che scalano.

https://api.frihet.io/v1 v1 — 2026-03-18 OpenAPI 3.1 · 82 paths · 137 operations

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