REST API — Dokumentation

Integrieren Sie 1invoice.online in Ihre eigenen Systeme. Die API folgt REST-Konventionen und gibt JSON zurück. Stabil unter /api/v1 — wir erhöhen die Version bei Breaking Changes.

Schnellstart

Loggen Sie sich ein und gehen Sie zu Einstellungen → REST API
Klicken Sie auf "Schlüssel erstellen", benennen Sie ihn und kopieren Sie den Wert (er wird nur einmal angezeigt)
Senden Sie den Schlüssel als Authorization: Bearer 1iv_...-Header bei Ihren Anfragen

Auth

Alle Endpunkte verlangen einen Bearer-Token im Authorization-Header. Schlüssel sind an die Organisation gebunden, in der sie erstellt wurden — Sie können nur Daten Ihrer eigenen Org lesen.

Authorization: Bearer 1iv_<Ihr Schlüssel>

Fehler-Responses

401 Unauthorized — Header fehlt oder Schlüssel ungültig/widerrufen
500 Internal Server Error — Datenbankfehler; erneut versuchen oder kontaktieren Sie uns

Discovery

GET /api/v1

Gibt eine Liste der verfügbaren Endpunkte zurück. Keine Credentials nötig.

Mitglieder

GET /api/v1/members?limit=50&offset=0&status=active

Gibt Mitglieder Ihrer Organisation zurück. Paginiert.

limit — Anzahl pro Seite (Standard 50, max. 200)
offset — Startposition (Standard 0)
status — Filter auf active, inactive, pending

Angebote

GET /api/v1/quotes?status=accepted

Gibt Angebote mit Status, Summe, public_token und Signatur-Info zurück.

Rechnungen

GET /api/v1/invoices?status=paid

Gibt Rechnungen mit Zahlungsstatus und Fälligkeitsdatum zurück.

Webhooks

Registrieren Sie eine URL unter Einstellungen → Webhooks. Bei einem Event POSTen wir JSON dorthin mit diesen Headern:

X-1Invoice-Event — Event-Name (z. B. invoice.paid)
X-1Invoice-Signature — HMAC-SHA256 des Rohbodys mit Ihrem Secret (Hex)
User-Agent: 1invoice-webhooks/1

Verfügbare Events

invoice.created, invoice.sent, invoice.paid
quote.created, quote.sent, quote.accepted, quote.rejected

Rate Limits

Soft-Limit: 60 Aufrufe/Minute pro Schlüssel. Bei Überlast erhalten Sie 429 Too Many Requests. Mehr nötig? Schreiben Sie uns — wir erhöhen es auf Anfrage.

Versionierung

Wir nutzen URL-Versionierung. /api/v1 ist stabil. Breaking Changes gehen in /api/v2 mit mindestens 6 Monaten paralleler Laufzeit.

Status & Changelog

Siehe Roadmap für den aktuellen Stand. API-Änderungen kündigen wir mit mindestens 30 Tagen Vorlauf via Webhooks und Dashboard-Banner an.

Fragen zur Integration?
Kontaktieren Sie uns — wir helfen Ihnen weiter. Die erste Integration dauert meist unter einer Stunde.