Frihet REST API
Programmatisk adgang til fakturaer, kunder, udgifter, produkter og tilbud. Designet til integrationer, der skalerer.
Lavet til udviklere
Partielle PATCH-opdateringer
Opdater kun de felter, du har brug for. Partielle schemas valideret med Zod garanterer integritet.
Søgning og filtre
Full-text søgning med parameter ?q=. Feltmapping pr. ressource for præcise resultater.
Batch-operationer
Opret op til 50 ressourcer i én enkelt anmodning. HTTP 207 multi-status svar.
Idempotensnøgler
Gentag anmodninger sikkert med Idempotency-Key-headeren. Nøgler genkendes i 24 timer.
Headers for hastighedsbegrænsning
X-RateLimit-Limit, Remaining og Reset i hvert svar. Planlæg derefter.
OpenAPI 3.1 specifikation
Maskinlæsbar specifikation på /openapi.yaml. 16 stier, 18 schemas. Genererer automatisk SDK'er.
Intelligens-endpoints
Forretningskontekst, månedlige oversigter og kvartalsvise skattedata via /context, /monthly, /quarterly.
Sikker VeriFactu sletning
Soft delete for fakturaer og ikke-kladde tilbud. Fuld sporbarhed for spansk skattemæssig overholdelse.
Endpoints
| 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);
Autentificering
Generer API-nøgler fra Indstillinger > API i dit Frihet-panel. Inkluder din nøgle som Bearer token i Authorization-headeren.
Authorization: Bearer fri_...
Begynd at integrere i dag
API-adgang inkluderet i alle planer. Din API-nøgle er klar i Indstillinger.
Start gratis