Sari la conținut

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 OpenAPI 3.1 · 82 paths · 137 operations

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. Cheile sunt recunoscute timp de 24 de ore.

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

Exemple de cod

                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);
              

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_...

Începe să integrezi azi

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

Începe Gratuit