API REST Frihet

Acces programatic la facturi, clienți, cheltuieli, produse și estimări. Proiectată pentru integrări care scalează.

https://api.frihet.io/v1 v1 — 2026-03-18

Creată pentru dezvoltatori

Actualizări parțiale PATCH

Actualizează doar câmpurile de care ai nevoie. Schemele parțiale validate cu Zod garantează integritatea.

Căutare și filtre

Căutare full-text cu parametrul ?q=. Maparea câmpurilor pe resursă pentru rezultate precise.

Operațiuni batch

Creează până la 50 de resurse într-o singură solicitare. Răspunsuri HTTP 207 multi-status.

Chei de idempotență

Reîncearcă solicitările în siguranță cu antetul Idempotency-Key. TTL de 24 de ore, susținut de Firestore.

Antete de limitare a ratei

X-RateLimit-Limit, Remaining și Reset în fiecare răspuns. Planifică în consecință.

Specificație OpenAPI 3.1

Specificație lizibilă de mașini în /openapi.yaml. 16 căi, 18 scheme. Generează SDK-uri automat.

Endpoint-uri de inteligență

Context de afaceri, rezumate lunare și date fiscale trimestriale via /context, /monthly, /quarterly.

Ștergere sigură VeriFactu

Soft delete pentru facturi și estimări non-ciornă. Trasabilitate completă pentru conformitatea fiscală spaniolă.

Endpoint-uri

Method	Path	Description
GET	/v1/invoices	Listează facturi
POST	/v1/invoices	Creează factură
PATCH	/v1/invoices/:id	Actualizează factură
DELETE	/v1/invoices/:id	Șterge factură
POST	/v1/invoices/batch	Creează facturi în batch
GET	/v1/clients	Listează clienți
POST	/v1/clients	Creează client
GET	/v1/expenses	Listează cheltuieli
POST	/v1/expenses	Creează cheltuială
GET	/v1/products	Listează produse
GET	/v1/quotes	Listează estimări
GET	/v1/context	Context de afaceri
GET	/v1/monthly	Rezumat lunar
GET	/v1/quarterly	Impozite trimestriale
GET	/openapi.yaml	Specificație OpenAPI

Exemple de cod

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']

Autentificare

Generează chei API din Setări > API în panoul tău Frihet. Include cheia ta ca Bearer token în antetul Authorization.

Authorization: Bearer fri_...

Documentație completă API MCP Server

Începe să integrezi azi

Accesul la API este inclus în toate planurile. Cheia ta API este gata în Setări.

Începe Gratuit