Zum Inhalt springen

Frihet REST-API

Programmatischer Zugriff auf Rechnungen, Kunden, Ausgaben, Produkte und Angebote. Entwickelt für skalierbare Integrationen.

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

Für Entwickler gemacht

Partielle PATCH-Updates

Aktualisieren Sie nur die Felder, die Sie benötigen. Partielle Schemata, validiert mit Zod, gewährleisten die Integrität.

Suche und Filter

Volltextsuche mit Parameter ?q=. Feldzuordnung pro Ressource für präzise Ergebnisse.

Batch-Operationen

Erstellen Sie bis zu 50 Ressourcen in einer einzigen Anfrage. HTTP 207 Multi-Status-Antworten.

Idempotenzschlüssel

Wiederholen Sie Anfragen sicher mit dem Idempotency-Key-Header. Schlüssel werden 24 Stunden lang erkannt.

Ratenbegrenzungs-Header

X-RateLimit-Limit, Remaining und Reset in jeder Antwort. Planen Sie entsprechend.

OpenAPI 3.1 Spezifikation

Maschinenlesbare Spezifikation unter /openapi.yaml. 16 Pfade, 18 Schemata. Generiert automatisch SDKs.

Intelligence-Endpunkte

Geschäftskontext, monatliche Zusammenfassungen und vierteljährliche Steuerdaten über /context, /monthly, /quarterly.

Sichere VeriFactu-Löschung

Soft Delete für Nicht-Entwurfsrechnungen und Angebote. Vollständige Nachverfolgbarkeit zur Einhaltung der spanischen Steuervorschriften.

Endpunkte

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

Codebeispiele

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

Authentifizierung

Generieren Sie API-Schlüssel unter Einstellungen > API in Ihrem Frihet-Panel. Fügen Sie Ihren Schlüssel als Bearer-Token im Authorization-Header ein.

Authorization: Bearer fri_...

Beginnen Sie noch heute mit der Integration

API-Zugang in allen Plänen enthalten. Ihr API-Schlüssel ist in den Einstellungen verfügbar.

Kostenlos starten