Frihets REST API
Programmatisk tilgang til fakturaer, kunder, utgifter, produkter og tilbud. Designet for integrasjoner som skalerer.
Laget for utviklere
Delvise PATCH-oppdateringer
Oppdater bare feltene du trenger. Delvise skjemaer validert med Zod garanterer integritet.
Søk og filtre
Fulltekstsøk med parameter ?q=. Feltmapping per ressurs for presise resultater.
Batch-operasjoner
Opprett opptil 50 ressurser i en enkelt forespørsel. HTTP 207 multi-status svar.
Idempotensnøkler
Prøv forespørsler på nytt på en trygg måte med Idempotency-Key-headeren. Nøkler gjenkjennes i 24 timer.
Ratelimit-headers
X-RateLimit-Limit, Remaining og Reset i hvert svar. Planlegg deretter.
OpenAPI 3.1 spesifikasjon
Maskinlesbar spesifikasjon i /openapi.yaml. 16 paths, 18 schemas. Genererer SDKer automatisk.
Intelligens-endepunkter
Forretningskontekst, månedlige sammendrag og kvartalsvise skattedata via /context, /monthly, /quarterly.
Sikker sletting VeriFactu
Soft delete for ikke-kladde fakturaer og tilbud. Full sporbarhet for spansk skattesamsvar.
Endepunkter
| 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 |
Kodeeksempler
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);
Autentisering
Generer API-nøkler fra Innstillinger > API i ditt Frihet-panel. Inkluder din nøkkel som Bearer token i Authorization-headeren.
Authorization: Bearer fri_...
Begynn å integrere i dag
API-tilgang inkludert i alle planer. Din API-nøkkel er klar i Innstillinger.
Start Gratis