bautagebuch.org per REST anbinden
Lies deine Projekte und die fertigen Tagesberichte als JSON aus und übernimm sie in dein ERP, Controlling oder BI. Ein Bearer-Token genügt, die Daten liegen auf Servern in Deutschland.
Überblick
Die API ist eine schlanke, read-only REST-Schnittstelle. Alle Antworten sind JSON und beginnen mit { "ok": true, … }. Jeder Zugriff ist an dein Konto gebunden, du siehst also genau die Projekte und Berichte, die dir auch im Cockpit gehören.
| Basis-URL | https://bautagebuch.org/api/v1 |
|---|---|
| Format | JSON (Anfragen und Antworten) |
| Anmeldung | Bearer-Token im Authorization-Header |
| Zugriff | Nur lesend (read), auf dein Konto beschränkt |
| Limit | 1500 Anfragen / 15 Minuten pro IP |
| Hosting | Deutschland, DSGVO-konform |
Anmeldung
Jede Anfrage trägt deinen API-Schlüssel als Bearer-Token. Den Schlüssel bekommst du auf Anfrage über support@bautagebuch.org; er wird dir einmalig angezeigt und ist danach nur als Prüfsumme gespeichert.
# Test, ob dein Schlüssel funktioniert
curl -H "Authorization: Bearer bt_XXXXXXXX.YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY" \
https://bautagebuch.org/api/v1/me
Endpunkte
| Endpunkt | Zweck |
|---|---|
| GET /me | Dein Konto und die vergebenen Rechte, gut zum Testen des Schlüssels. |
| GET /projects | Alle deine Baustellen mit Name und Adresse. |
| GET /projects/:id/reports ?from=&to= | Liste der Tage mit Bericht in einem Zeitraum (Datum im Format JJJJ-MM-TT). |
| GET /projects/:id/reports/:date | Der fertige Tagesbericht eines Tages: Zusammenfassung, ausgeführte Arbeiten, Vorkommnisse, Wetter, VOB-Felder und Freigabestatus. |
Beispiel: Berichte einer Baustelle im Zeitraum
curl -H "Authorization: Bearer bt_XXXXXXXX.YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY" \
"https://bautagebuch.org/api/v1/projects/42/reports?from=2026-06-01&to=2026-06-30"
Beispiel-Antwort: ein Tagesbericht
{
"ok": true,
"report": {
"date": "2026-06-15",
"generator": "editor:vob",
"executiveSummary": "…",
"workPerformed": "…",
"incidents": "…",
"weather": "…",
"approvalStatus": "approved"
}
}
Limits und Fehler
Aktuell sind 1500 Anfragen pro 15 Minuten und IP-Adresse erlaubt. Die verbleibenden Anfragen stehen in den RateLimit-*-Antwort-Headern. Wird das Limit überschritten, kommt Status 429 als JSON. Ein ungültiger oder fehlender Token liefert 401, eine unbekannte Baustelle oder ein fehlender Bericht 404 — jeweils mit { "ok": false, "error": … }.