Vollständige REST-API für Hausverwaltungs-Daten — Properties, Tenancies, Tickets, Statements und Webhooks.
API-Key erstellen, curl-Aufruf, fertig. Kein OAuth-Dance.
10 Event-Types mit HMAC-SHA256-Signatur. 5x-Retry mit exponential Backoff.
Hash-on-Issue, Scopes für Permissions, Revoke jederzeit.
# 1) API-Key generieren in Einstellungen → API-Keys
# 2) curl mit Bearer-Token
curl -H "Authorization: Bearer clra_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
https://api.clarora.de/v1/properties// TypeScript / Node.js
const res = await fetch('https://api.clarora.de/v1/properties', {
headers: {
'Authorization': 'Bearer clra_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
});
const properties = await res.json();# Python (requests)
import requests
resp = requests.get(
'https://api.clarora.de/v1/properties',
headers={'Authorization': 'Bearer clra_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxx'},
)
properties = resp.json()// Webhook-Handler-Beispiel (Express)
import crypto from 'node:crypto';
app.post('/clarora-webhook', (req, res) => {
const sig = req.headers['x-clarora-signature'].replace('sha256=', '');
const expected = crypto.createHmac('sha256', SECRET)
.update(req.rawBody).digest('hex');
if (sig !== expected) return res.status(401).send();
// process req.body...
res.status(200).send();
});