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

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. TTL di 24 ore, supportato da Firestore.

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	Description
GET	/v1/invoices	Elencare fatture
POST	/v1/invoices	Creare fattura
PATCH	/v1/invoices/:id	Aggiornare fattura
DELETE	/v1/invoices/:id	Eliminare fattura
POST	/v1/invoices/batch	Creare fatture in batch
GET	/v1/clients	Elencare clienti
POST	/v1/clients	Creare cliente
GET	/v1/expenses	Elencare spese
POST	/v1/expenses	Creare spesa
GET	/v1/products	Elencare prodotti
GET	/v1/quotes	Elencare preventivi
GET	/v1/context	Contesto di business
GET	/v1/monthly	Riepilogo mensile
GET	/v1/quarterly	Imposte trimestrali
GET	/openapi.yaml	Specificazione OpenAPI

Esempi di codice

curl https://api.frihet.io/v1/invoices \
  -H "Authorization: Bearer fri_..." \
  -H "Content-Type: application/json"

const res = await fetch('https://api.frihet.io/v1/invoices', {
  headers: {
    'Authorization': 'Bearer fri_...',
    'Content-Type': 'application/json',
  },
});
const { data, meta } = await res.json();

import requests

res = requests.get(
    'https://api.frihet.io/v1/invoices',
    headers={'Authorization': 'Bearer fri_...'}
)
data = res.json()['data']

Autenticazione

Genera chiavi API da Impostazioni > API nel tuo pannello Frihet. Includi la tua chiave come Bearer token nell'header Authorization.

Authorization: Bearer fri_...

Documentazione completa dell'API MCP Server

Inizia a integrare oggi

Accesso all'API incluso in tutti i piani. La tua chiave API è pronta in Impostazioni.

Inizia Gratis