Build mit buchkram.
REST-API, signierte Webhooks, OAuth-fähige Personal-Access-Tokens. Pro Tenant isoliert.
📘
REST-API v1
Customers, Invoices, Receipts, Projects, Zeiten, Bank-Transaktionen.
🔔
Webhooks
Signierte HTTP-Callbacks bei Events. Mit Retry + Audit-Log.
📝
Changelog
Was neu, was deprecated, was kommt.
Schnellstart
- Konto anlegen oder einloggen
- Im Dashboard: Einstellungen → API-Tokens → "Token generieren"
- Token kopieren (nur einmal sichtbar)
- API-Call mit
Authorization: Bearer <token>
# Erste API-Call: dein Profil + Tenant
curl https://buchkram.de/api/v1/me \
-H "Authorization: Bearer 12|aBcDeF..."
# Alle Kunden listen
curl https://buchkram.de/api/v1/customers \
-H "Authorization: Bearer 12|aBcDeF..."
# Neue Rechnung anlegen
curl -X POST https://buchkram.de/api/v1/invoices \
-H "Authorization: Bearer 12|aBcDeF..." \
-H "Content-Type: application/json" \
-d '{
"customer_id": "uuid-here",
"invoice_date": "2026-05-15",
"due_date": "2026-05-29",
"subject": "Mai-Beratung",
"status": "issued",
"items": [
{"title": "Beratung", "quantity": 8, "unit": "h", "unit_price_net": 120, "vat_rate": 19}
]
}'
Designprinzipien
- REST + JSON — keine GraphQL-Komplexität, klare Ressourcen
- UUIDs für alle Geschäftsobjekte (Customers, Invoices, etc.) — Integer nur für User
- Tenant-Isolation automatisch über den Token-Scope, kein
X-Tenant-Id-Header - Rate Limit: 60 req/min pro Token (Standard-API-Limit)
- Idempotenz: über
Idempotency-Key-Header für POSTs (in V3.1) - Audit-Log: jeder Call wird mit Method, Path, Status, Latenz protokolliert
Support
Bug oder Frage? Support-Ticket öffnen. Beta-Kunden bekommen Antwort innerhalb von 24 Stunden werktags.