Technische Wege im aktuellen Stand · R86 Diese Dokumentation beschreibt bestehende Sitzungs-APIs, keine stabile externe Entwickler-API mit Langzeitkompatibilitätszusage. Anmeldung: persönlicher Firmenzugang über die jeweilige Programmadresse; Sitzung im HttpOnly-Cookie. /api/state liefert den aktuell berechtigten Zustand einschließlich CSRF-Token. Firmenzuordnung und Rollen kommen serverseitig aus der Sitzung. Keine öffentliche API-Schlüssel- oder OAuth-Schnittstelle eingerichtet. Schreibaktionen: POST /api/, Content-Type application/json, eigener Origin und X-CSRF-Token der aktuellen Sitzung. Einzelne Vorgänge verlangen zusätzliche Module und Projektzuweisungen. Lesen/Export in Geschäftsprogrammen: GET /api/state – nur der rollenbezogene sichtbare Firmenzustand, kein fremder Mandant über Parameter. GET /api/export – Admin/Büro; JSON-Container gewerksuit-export-1 mit data und programmabhängigen Zusatzbereichen. Online-Learn/Start/Web/ChatAI haben eigene Exportinhalte. Ein JSON-Export allein ist keine garantierte vollständige Rücksicherung. GET /api/pdf?id=&kind=invoice – berechtigtes Original-Rechnungs-PDF; kind=cancel für Storno. Kunden nur bei expliziter Freigabe des eigenen Belegs. GET /api/quote-pdf?id= – berechtigte festgeschriebene Angebotsfassung. GET /api/xrechnung?id=&kind=invoice – strukturierte E-Rechnung nur im unterstützten Umfang und nach KoSIT-Prüfung; Rollen und Firma bleiben geprüft. GET /api/flow-mobile – persönlicher Online-Flow-Mitarbeiter-Schnappschuss; kein Desktopzugang. POST /api/flow_mobile_submit – aktuell gültige eigene assignment_id/project_id, day, work, issues, minutes, break_minutes, optional photo/photo_name und gebundener request_key. Identischer bestätigter Schlüssel wird nicht doppelt gebucht; abweichender Inhalt wird abgewiesen. Rechteentzug kann alte Offlineentwürfe blockieren. Kein generisches Last-write-wins-Zusammenführen. Grenzen: reguläre Sitzung acht Stunden; Foto in dieser Strecke höchstens 1 MB, Browserentwürfe höchstens 3 MB und Gerätepasswort erforderlich. Upload-/Aktionsgrenzen sind je Route unterschiedlich. Es gibt keine behauptete allgemeine externe API-Rate-Limit- oder Webhook-SLA. 400: ungültiger fachlicher Vorgang; 403: fehlende Rechte/Sitzung/CSRF/Herkunft; Fehlerdetails im JSON error. Nur dokumentierte request_key-Vorgänge idempotent wiederholen; ein unklarer Mail-/Zahlungsstatus darf nicht pauschal neu gesendet werden. Webhooks: kein allgemeines kundenseitiges Ereignisabonnement. Bestehende Digistore24-IPN/PayPal-Zahlungsrückmeldungen sind geschützte Anbieterwege; sie sind keine Kunden-Webhooks und werden in diesem Paket nicht aktiviert oder mit Testzahlungen angesprochen. Portabilität und Restore: datenexport.json dokumentiert den synthetischen nativen fachlichen Zustand, nicht die vollständige kontenbezogene HTTP-Antwort. IDs sind tabellenlokale Schlüssel; project.customer_id, order.project_id/quote_id, invoice.order_id, payment.invoice_id, cancellation.invoice_id und refund.cancellation_id erhalten die Referenzketten. Geldbeträge *_cents sind Ganzzahlen; Menge und Dezimalwerte bleiben entsprechend ihrem Schema erhalten. Nicht jedes Feld ist ein Geldwert. Echte Belegnummern werden nicht aus IDs neu erfunden. DEMO-Sicherung.zip ist das native vollständige gewerksuit-backup-1-Sicherungsformat. manifest.json enthält Dateinamen und SHA-256 jeder Datenbank. Geschäftsdatenbanken enthalten die privaten Anhänge sowie Original-/PDF-Schnappschüsse; accounts.sqlite enthält ausschließlich fiktive Testbenutzer und Passworthashes. Nur in einem neuen Testordner über gewerk.backup.restore zurückspielen. Die Sicherung ist absichtlich öffentlich und darf niemals mit realen Passwörtern oder Daten verwendet werden. Die Rückspielroutine widerruft Sitzungen. Server-/Provider-Schlüssel sind getrennt zu sichern und nicht Teil dieses portablen Testpakets. Der öffentliche Prüflauf greift nicht auf Kundendatenbanken zu.