Frihet REST-API
Programmatischer Zugriff auf Rechnungen, Kunden, Ausgaben, Produkte und Angebote. Entwickelt für skalierbare Integrationen.
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