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

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. 24 órás TTL, Firestore támogatással.

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	Description
GET	/v1/invoices	Számlák listázása
POST	/v1/invoices	Számla létrehozása
PATCH	/v1/invoices/:id	Számla frissítése
DELETE	/v1/invoices/:id	Számla törlése
POST	/v1/invoices/batch	Számlák létrehozása kötegelten
GET	/v1/clients	Ügyfelek listázása
POST	/v1/clients	Ügyfél létrehozása
GET	/v1/expenses	Költségek listázása
POST	/v1/expenses	Költség létrehozása
GET	/v1/products	Termékek listázása
GET	/v1/quotes	Árajánlatok listázása
GET	/v1/context	Üzleti kontextus
GET	/v1/monthly	Havi összefoglaló
GET	/v1/quarterly	Negyedéves adók
GET	/openapi.yaml	OpenAPI Specifikáció

Kódpéldák

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

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

Az API teljes dokumentációja MCP Server

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