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