Ugrás a tartalomhoz

Frihet REST API

Programozott hozzáférés számlákhoz, ügyfelekhez, kiadásokhoz, termékekhez és árajánlatokhoz. Skálázható integrációkhoz tervezve.

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

Fejlesztőknek készült

Részleges frissítések PATCH

Csak azokat a mezőket frissítsd, amelyekre szükséged van. A Zod-dal validált részleges sémák garantálják az integritást.

Keresés és szűrők

Teljes szöveges keresés ?q= paraméterrel. Mezők erőforrásonkénti leképezése a pontos eredményekért.

Kötegelt műveletek

Akár 50 erőforrás létrehozása egyetlen kérésben. HTTP 207 többállapotú válaszok.

Idempotencia kulcsok

Biztonságosan ismételd meg a kéréseket az Idempotency-Key fejléc segítségével. A kulcsokat 24 órán át felismeri a rendszer.

Sebességkorlátozási fejlécek

X-RateLimit-Limit, Remaining és Reset minden válaszban. Tervezz ennek megfelelően.

OpenAPI 3.1 Specifikáció

Gép által olvasható specifikáció az /openapi.yaml címen. 16 útvonal, 18 séma. Automatikusan generál SDK-kat.

Intelligencia végpontok

Üzleti kontextus, havi összefoglalók és negyedéves adóadatok a /context, /monthly, /quarterly útvonalakon keresztül.

Biztonságos VeriFactu törlés

Soft delete számlákhoz és nem piszkozat árajánlatokhoz. Teljes nyomonkövethetőség a spanyol adóügyi megfeleléshez.

Végpontok

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

Kódpéldák

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

Hitelesítés

Generálj API kulcsokat a Beállítások > API menüben a Frihet panelen. Foglald bele a kulcsodat Bearer tokenként az Authorization fejlécbe.

Authorization: Bearer fri_...

Kezdj el integrálni még ma

API hozzáférés minden csomagban. Az API kulcsod a Beállításokban található.

Kezdje ingyen