Zum Inhalt springen
Zum Inhalt springen

Dokumentation

Der zentrale Einstieg für Anleitungen, Administration und die technische Integration. Wählen Sie den passenden Bereich oder lesen Sie direkt in den API- und CLI-Verträgen.

Kategorien

  • ▼API & Integration
    • Backend-API: Discovery, Abos & Apps (Agenten-Skill)
    • API-Quickstart: in 5 Minuten zum ersten Call
    • API-Fähigkeitsindex: Module & Domänen
    • CLI „itt“ — Apps & API von der Kommandozeile
  • ▶Blog
  • ▶KI-gestützte Softwareentwicklung

API & Integration - Backend-API: Discovery, Abos & Apps (Agenten-Skill)

it-tremmel.de Backend-API — Discovery, Abos & Apps

Dieser Leitfaden ist die öffentliche Ausgabe unseres internen Agenten-Skills für die it-tremmel.de-Plattform-API. Er richtet sich an Entwickler:innen und KI-Agenten, die die Plattform per HTTP nutzen wollen: Endpunkte entdecken, sich authentifizieren, Apps steuern, Abos bestellen und verwalten, Daten pseudonymisieren und Systeme miteinander verdrahten.

Siehe auch in dieser Kategorie: der API-Quickstart — in 5 Minuten zum ersten Call (Sandbox → erster Aufruf → SDK → App-State) und der API-Fähigkeitsindex — Module & Domänen (automatisch generierte Übersicht der fachlichen API-Module).

Zeitlos statt Momentaufnahme: Endpunkte kommen hinzu, werden umbenannt oder aufgeteilt. Dieser Text friert deshalb keine Endpunktliste ein, sondern zeigt, wo die jeweils aktuelle Wahrheit lebt und wie man sie liest. Die genannten Pfade sind erprobte Beispiele — vor Benutzung immer gegen die Live-Spezifikation prüfen.

1. Discovery: die Quelle der Wahrheit

Die maschinenlesbare API-Beschreibung liefert der Server selbst (OpenAPI):

| Zweck | Endpunkt | | ------------------------------------------- | ----------------------------------- | | Interaktive Doku (Swagger UI) | GET /api/docs | | Aggregierte Spezifikation (JSON) | GET /api/docs/openapi.json | | Aggregierte Spezifikation (YAML) | GET /api/docs/openapi.yaml | | Verfügbare Spec-Bundles | GET /api/docs/specs | | Ein Bundle, z. B. public-openapi | GET /api/docs/specs/{name} | | Kuratierte Code-Beispiele | GET /api/docs/examples | | Fehlercode-Katalog | GET /api/docs/errors | | Typisierter Client (TypeScript/PHP) | GET /api/docs/sdk/{spec}/{target} | | Vollständige Spezifikation (nur angemeldet) | GET /api/docs/openapi-full.json |

Anonym sichtbar sind Gesundheits-/Basisdaten (GET /api/health) und die öffentlichen Spec-Bundles; die detaillierte Pfadliste ist erst nach Authentifizierung abrufbar. Wer nur ausprobieren will, startet mit einer Sandbox: POST /api/sandbox/provision liefert eine isolierte, zeitlich befristete Testumgebung mit eigenem Sandbox-API-Key (Status/Löschen über GET /api/sandbox/status/{id} bzw. DELETE /api/sandbox/{id} mit X-Sandbox-Key). Die Provisionierung ist bewusst streng ratenlimitiert.

2. Authentifizierung, Mandanten, Fehlerbild

  • In-App / gleiche Origin (Portal, Mini-Apps): JWT (Cookie oder Authorization: Bearer) plus CSRF-Token (X-CSRF-Token) für schreibende Aufrufe.
  • Dedizierte API-Hosts / Server-zu-Server: X-API-Key. Bei mandantengebundenen Schlüsseln stammt der Mandant aus dem gespeicherten Schlüsselsatz; X-Tenant-Id kann die Bindung nur bestätigen, sofern der jeweilige Endpunkt den Header nicht ausdrücklich verlangt. Beim mandantenlosen Pseudonymizer-Admin-Schlüssel steht tenant_id verpflichtend in der JSON-Nutzlast. Ein frei gesetzter Header wählt niemals still einen anderen Mandanten; maßgeblich ist die Live-Spezifikation des Endpunkts.
  • Mandantenfähigkeit ist Pflicht: Jeder Aufruf läuft im Kontext genau eines Mandanten; mandantenübergreifender Zugriff ist ausgeschlossen.
  • Fehler kommen immer im selben JSON-Umschlag:
{
  "status": "error",
  "code": "UNAUTHORIZED",
  "message": "Authentication token required.",
  "error": "invalid_credentials",
  "requestId": "0cafe291-…"
}

Programmatisch auf code (GROSS_SCHREIBWEISE) oder error (klein_schreibweise) verzweigen, nie auf message. Jede Fehlerantwort trägt zusätzlich eine help_url in den Fehlercode-Katalog (GET /api/docs/errors#<code> — JSON, als HTML lesbar). Bei Support-Anfragen die requestId mitschicken. Statuscodes: 400 fehlerhafte Anfrage, 401 nicht angemeldet, 403 verboten, 404 nicht gefunden, 409 Konflikt, 422 Validierung/Geschäftsregel, 429 Ratenlimit. Geldbeträge sind ganzzahlige Minor Units (Cent) bzw. Dezimalstrings — nie Floats.

Lesen ist offen, Schreiben kann kostenpflichtig sein

Bei manchen Routenfamilien wird ein maschineller Aufrufer bewusst anders behandelt als ein Mensch im Browser. Die Portal-Familie (/api/portal/**) ist der Referenzfall:

  • Abfragen bleibt frei. Ein Agent kann die Portale ueber die OpenAPI-Endpunkte lesen, ohne bezahltes Konto — etwa GET /api/portal/listings, GET /api/portal/listings/{id} oder GET /api/portal/categories/{id}/listings.
  • Schreiben ist kostenpflichtig. Ein Inserat anlegen (POST /api/portal/listings, POST /api/portal/{tenantId}/listings) und eine Person kontaktieren (POST /api/portal/listings/{id}/contact, POST /api/portal/{tenantId}/inquiries) setzt fuer programmatische Aufrufer ein angemeldetes Konto mit aktivem, bezahltem Abo in genau diesem Mandanten voraus.
  • Entschieden wird anhand der geprueften Zugangsdaten, nicht anhand eines frei setzbaren Kopfzeilenwerts. Massgeblich ist, womit Sie sich authentifiziert haben (API-Schluessel, persoenliches Zugriffstoken, Agenten-Token). Ein User-Agent spielt keine Rolle; ein nicht pruefbarer Maschinen-Zugang macht die Anfrage nur strenger.
  • Die Ablehnungen sind unterscheidbar — bitte auf code verzweigen: 401 AUTH_REQUIRED (zuerst anmelden bzw. den authentifizierten Endpunkt verwenden), 403 PAID_ACCOUNT_REQUIRED (angemeldet, aber ohne aktives bezahltes Abo), 403 WRITE_CHANNEL_DISABLED (dieser Zugangsweg ist fuer dieses Portal abgeschaltet). 429 bleibt davon unabhaengig das Ratenlimit.
  • Das Abo gilt je Mandant. Ein bezahltes Konto auf einem Portal schaltet kein Schwesterportal frei; ein abgelaufenes Abo zaehlt nicht.
  • Der oeffentliche Weg im Browser bleibt unberuehrt: eine anonyme, per Captcha geprueste Eintragung ist weiterhin kostenlos und ohne vorherige Registrierung moeglich. Weil jedes Portal seine Regel je Zugangsweg selbst setzen kann, gilt: das tatsaechliche Verhalten immer aus der aktuellen OpenAPI-Beschreibung bestaetigen, nicht aus dieser Seite ableiten.

Dauerhafte Beta-Test-Sitzungen

Für automatisierte Prüfungen geschützter Beta-Bereiche wird niemals das Owner-Konto verwendet. Jeder Beta-Host erhält einen eigenen, auf genau einen leeren Testmandanten begrenzten E2E-Benutzer. Der Test meldet sich einmal real an, bestätigt die eigene Mandanten-ID über /api/auth/me, erwartet für einen fremden Mandanten 403 und verwendet danach den gespeicherten Cookie-Zustand weiter. Dadurch bleibt das absichtlich enge Login-Ratenlimit intakt.

3. Abo bestellen und verwalten (Ihr Plattform-Abo)

Das eigene Plattform-Abo (Plan, Zahlung, Rechnungen) wird unter /api/billing/… verwaltet — angemeldet, mandantenbezogen:

  • Informieren: GET /api/billing/plans (Plankatalog), GET /api/billing/upgrade-paths, GET /api/billing/plan-change-preview (Vorschau inkl. anteiliger Verrechnung vor einem Planwechsel).
  • Bestellen: POST /api/billing/subscribe startet ein Abo über einen Zahlungsanbieter (z. B. Stripe oder PayPal). Geldbewegende Aufrufe (subscribe, quota/purchase-addon, refunds) akzeptieren einen Idempotency-Key-Header: Wiederholungen mit demselben Schlüssel werden nicht doppelt ausgeführt, sondern liefern die gespeicherte Antwort erneut. Alternativ zuerst testen: POST /api/billing/trial/start — die Testphase schaltet sofort die regulären Monats-Credits des Plans frei; später POST /api/billing/trial/convert.
  • Einsehen: GET /api/billing/my-plan und GET /api/billing/subscription zeigen den aktiven Plan, Laufzeit und Status.
  • Ändern: Planwechsel/Downgrade, POST /api/billing/cancel, POST /api/billing/pause, POST /api/billing/resume, POST /api/billing/reactivate. Kündigungen mitten im Zeitraum werden taggenau anteilig gutgeschrieben — vorab einsehbar über GET /api/billing/cancel-preview (Enddatum, Gutschrift, entfallende Module, offene Rechnungen; rein lesend).
  • Zahlung: GET/POST /api/billing/payment-methods (inkl. Standard-Zahlungsmittel), SEPA-Mandate unter /api/billing/sepa/….
  • Belege: GET /api/billing/invoices, PDF je Rechnung über GET /api/billing/invoices/{id}/pdf; Korrekturen (Storno/Gutschrift) haben eigene Endpunkte.
  • Verbrauch & Kontingente: GET /api/billing/usage/current, GET /api/billing/quota, Erweiterungen über POST /api/billing/quota/purchase-addon; Add-on-Katalog unter /api/billing/addons/….

Planabhängige Module sind serverseitig „gegated“: Fehlt dem Plan ein Modul, antwortet die API mit 403 — das Upgrade (siehe upgrade-paths) schaltet es frei.

4. Apps aktivieren, ordnen und verwalten

Welche Mini-Apps auf Ihrem Konto laufen, steuern Sie per API:

  • /api/my-apps — Ihre App-Instanzen: GET (Liste), POST (App hinzufügen), PUT /api/my-apps/reorder (Reihenfolge im App-Hub), PUT/DELETE /api/my-apps/{instanceId} (konfigurieren/entfernen).
  • /api/offers — Angebote, die Ihnen unterbreitet wurden: GET (Liste), GET /{offerId} (Detail), POST /{offerId}/accept (Bestellung!) bzw. POST /{offerId}/decline.
  • /api/app-bundles — kuratierte App-Pakete (auch Branchen-Presets): GET, GET /active, POST /activate, POST /deactivate. Ein Bundle aktiviert eine sinnvoll vorverdrahtete App-Kombination in einem Schritt; GET /api/app-bundles/{id}/preview zeigt vorab, welche Apps hinzukämen, was schon vorhanden ist und wie der Plan-Status je App aussieht.
  • Alles auf einen Blick: GET /api/me/overview liefert Benutzer, Mandant, Plan/Trial, aktive Apps & Bundles, Kontingent-Überblick und Plan-Gating in einem einzigen Aufruf (30 s cachebar) — der empfohlene erste Call jeder Integration nach dem Login.

Diese Routen sind moderat ratenlimitiert (429 sauber behandeln) und schreibende Aufrufe brauchen das CSRF-Token (Abschnitt 2).

5. Eigene Kunden-Abos abbilden (Subscriptions-Engine)

Nicht zu verwechseln mit Abschnitt 3: Unter /api/subscriptions stellt die Plattform eine vollständige Abo-Engine für Ihre eigenen Kunden bereit — Pläne und Add-ons anlegen, Abos starten/verlängern/kündigen, nutzungsbasierte Abrechnung (Messwerte erfassen und bewerten), anteilige Verrechnung sowie Kennzahlen wie MRR, ARR, Churn und NRR. Damit bauen Sie Ihr eigenes SaaS-Geschäft auf der Plattform auf.

6. Maschinelle Kunden — die API als LLM-Agent einkaufen und nutzen

Fremde KI-Agenten sind Kunden. Vier Routen genügen; Details liefert immer die Live-Discovery (GET /api/docs/specs/AgentAuth):

  1. Schaufenster, öffentlich: GET /api/agents/catalog — Zugangspass (net_minor_units, vat_percent als ganze Zahl, gross_minor_units, period_days, auto_renew: false), Nutzungspreise in Credits (metering.rate_card), Kontingent-Vertrag (quota), Scopes und alle capabilities[] mit Routenmuster und Pflicht-Scope. Mit Agent-Token liefert derselbe Aufruf zusätzlich das eigene entitlement (Zugangs-Uhr, Scopes, quota.used/remaining) — streng mandantenbezogen.

  2. Kauf als bewusste Wahl in zwei Schritten: POST /api/agent-auth/self-service/orders mit Idempotency-Key und X-Tenant-Id gleich tenant_id im Body → order_id, claim_token, Betrag, Status payment_pending (nichts wird belastet, kein Schlüssel existiert). Ohne Idempotenzschlüssel: 422 idempotency_key_required. Bezahlen kann der Agent selbst: POST /api/acp/checkout_sessions mit X-Tenant-Id gleich dem Mandanten der Bestellung und genau einem Artikel agent_access_pass:<order_id> (Menge 1, buyer.email), danach POST …/checkout_sessions/{id}/complete mit payment_data.provider bank_transfer (Überweisungsdaten in der Antwort, Zahlung gilt erst nach Verbuchung durch den Händler als eingegangen) oder x402 (sofort verbucht). Die Antwort nennt die payment_transaction_id; der Betrag ist exakt der auf der Bestellung gespeicherte. GET /api/agent-auth/self-service/orders/{id} zeigt payment.status (unpaid | pending | settled) und trägt die Zahlungs-Id in next_step ein, sobald sie verbucht ist — nichts läuft außerhalb der API. Erst POST /api/agent-auth/self-service/orders/{id}/issue mit claim_token und dieser verbuchten, mandantengebundenen Zahlung über den exakten Betrag gibt den Token einmalig heraus. Jede Ausgabe trägt DocumentLinks-Kanten Bestellung → Zahlung und Bestellung → Token.

  3. Nutzen: Authorization: Bearer itt_agt_… ausschließlich auf den Routen der Agenten-Richtlinie (GET /api/erp/*, /api/search, /api/reporting/* …). Fremde Routen → 403 agent_scope_forbidden, fehlender Scope → 403 agent_scope_insufficient.

  4. Kontingent: GET /api/agent-auth/self-service/usage zeigt quota.budget/used/remaining je Token und Zugangsperiode. Ist das Budget erschöpft, antwortet jede Route mit 429 rate_limit_exceeded, Retry-After (Sekunden bis Periodenende), X-Agent-Quota-Used, X-Agent-Quota-Budget und X-Agent-Error: agent_quota_exhausted; abgewiesene Aufrufe verbrauchen nichts.

  5. Werkzeuge laden (LLM-Discovery): GET /api/agents/tools liefert JSON-Schema-Werkzeuge (name, description, inputSchema, x-itt.method/path/scope/metering), mechanisch aus dem kompilierten OpenAPI-Vertrag abgeleitet und auf die eigenen Scopes gefiltert — direkt als Function-Calling- oder MCP-Toolliste verwendbar (?prefix=/api/erp/&limit=100).

  6. Preis am Endpunkt, Zählung und Beleg: GET /api/docs/pricing (öffentlich) nennt je Fähigkeit den Preis in ganzen Cent (unit_price_minor, currency, unit), die zugeordneten Routen mit Scope und Personendaten-Kennzeichen, den Selbstbedienungs-Kauf und das Kontingent. Dieselben Zahlen stehen als x-itt-pricing an jeder bepreisten Operation der OpenAPI-Spezifikation und in /.well-known/agents.json (pricing, authentication.tokenIssuance.selfService); /.well-known/ai-plugin.json und /.well-known/openapi.json sind echte Dokumente, unbekannte /.well-known-Pfade antworten mit JSON-404. Ist beim Mandanten AGENT_USAGE_METERING eingeschaltet, wird jeder erfolgreiche Aufruf einer Katalog-Route als eine Verbrauchszeile gezählt (GET /api/agent-billing/usage), und jede Zeile trägt eine DocumentLinks-Kante zu ihrem Beleg und — nach der Abrechnung — zur Buchung im Guthaben-Konto; im Login-Bereich unter Meine Apps → API für Agenten (/my-apps/agent-access) navigierbar, öffentlich erklärt auf /api-fuer-agenten.

7. Was die Plattform sonst per API kann

  • Sprachsteuerung & Fernsteuerung: Mini-Apps sind steuerbar — per Spracheingabe (KI-gestützte Intent-Erkennung über den Plattform-KI-Proxy unter /api/ai/…) — mit Anbieterkette lokal/Cloud, konfigurierbarem Ausweichen (bei „nur lokal“ fail-closed), Anbieter/Latenz/Kosten je Antwort und der Statusprüfung GET /api/ai/providers/health und per einwilligungspflichtiger Fernsteuerung (/api/remote-steering/…: Sitzungen, Kommandos, Live-Events). Für agentengeführte Abnahmeläufe liefert GET /api/remote-steering/sessions/{id}/commands den PASS/FAIL-Zustand jedes Schrittes aus dem dauerhaften Kommando-Ledger zurück, und POST …/sessions/{id}/transport-url prägt die einmalige SSE-Nonce für den Verbindungsaufbau (das langlebige Transport-Token steht nie in der Stream-URL). Klick-/Warte-Ziele adressieren data-testid exakt (testid) oder per Präfix (testidPrefix, für dynamische Zeilen-Testids) — genau eines von beiden. Einwilligung, Rollenprüfung und Sitzungslimits erzwingt der Server. Für die Demo-Planung liefert GET /api/steering/capabilities (angemeldet, Support-Rolle, mandantengebunden) nur serverseitig autorisierte Funktionen mit Version, Risikoklasse, Zielidentität und begrenztem Argumentschema. Aufrufer können diese Felder nicht überschreiben. Inventarversion, Inhaltsdigest, Herkunft und kanonische Serverregistrierung werden geprüft; auch die Sprachausgabe braucht eine explizite mandantengebundene Berechtigung. manifest_version lehnt veraltete Pläne ab.
  • Chat-/Sprach-Composer, Befehls-Choreographie, „wer steuert gerade": Plattform-KI liefert SteeringComposer (Text oder Diktat per Web Speech API, katalog-gestützte Befehlserkennung, Befehlsvorschau mit ausdrücklicher Bestätigung — nie Auto-Ausführung — in DE/EN/ES), die App-übergreifende Befehlsfolge createCommandChoreoRunner/ChoreoStepList (je Schritt geplant/läuft/fertig/fehlgeschlagen/abgelehnt/abgebrochen, abbrechbar, destruktive Schritte fragen erneut) und SteeringControlBadge (eine Antwort: Sie · Operator · KI-Agent · Choreographie). Apps ohne eigene Befehle tragen den Mindestvertrag createMinimalSteering (open + set-filter) aus @it-tremmel.de/platform-steerable; Konvention und Proben: docs/steering-mindestvertrag.md.
  • PII-Pseudonymisierung: POST /api/pseudonymizer/pseudonymize ersetzt personenbezogene Daten in beliebigem JSON durch umkehrbare Tokens (verschlüsselt je Mandant), …/depseudonymize stellt sie wieder her — ideal, bevor Daten an Dritt-KI oder externe Tools gehen. Ein mandantengebundener API-Key verwendet ausschließlich seine gespeicherte Bindung; ein optionaler X-Tenant-Id-Header muss dazu passen. Der mandantenlose Admin-Key benötigt bei beiden Aufrufen tenant_id in der JSON-Nutzlast. Fehlt der Mandant oder widerspricht der Header, folgt 422; unbekannte beziehungsweise nicht berechtigte Mandanten ergeben 403. Einen Standardmandanten gibt es nicht. Endgültige DSGVO-Löschung ist davon getrennt.
  • App-Zustand geräteübergreifend: GET/PUT/DELETE /api/data/app-state/{namespace} synchronisiert Einstellungen und Entwürfe je Benutzer über Geräte hinweg (optimistische Versionierung).
  • Verdrahtung & Automatisierung: Webhooks (ein- und ausgehend), Automation-Bridge-Anbindung, Workflow-Automatisierung und typisierte Verknüpfungen zwischen Datensätzen verschiedener Apps. Eingehende Zahlungsanbieter- Webhooks (/api/webhooks/stripe, /api/webhooks/paypal) werden signaturgeprüft angenommen.
  • Rückfragen an den Mandanten: Automatisierungen können dem Mandanten strukturierte Fragen oder Unterlagen-Anforderungen stellen (POST /api/approval-sync/questions, API-Key-geschützt) und die Antwort programmatisch abholen (GET …/questions?statuses=answered). Beantwortet wird im Login-Bereich unter „Mandanten-Rückfragen“ — als Freitext, per Antwortoption oder mit Datei-Uploads über die Dokumentenverwaltung.
  • Ausgehende E-Mails als Prüf-Warteschlange: E-Mails verlassen die Plattform über eine Entwurfs-Warteschlange (POST /api/communication/email-drafts); der Mandant prüft und gibt frei, danach stellt der Versand zu. ⚠️ Ein erfolgreich versandter Entwurf antwortet auf der Einzelabfrage mit 404 (gemessen am 2026-08-19): der Versand setzt zusammen mit dem Endstatus einen Löschzeitstempel, und GET /api/communication/email-drafts/{id} wertet diesen als „nicht gefunden“. Ein 404 heißt dort also in aller Regel zugestellt, nicht „verloren“. Der tragfähige Leseweg ist die Liste mit GET /api/communication/email-drafts?include_terminal=1 — Zustellung wird an status und sent_at dieser Liste abgelesen, nie an der Einzelabfrage. Der HTML-Inhalt steht in dieser Liste im Feld body_html und kommt vollständig mit, ohne zusätzlichen Parameter; reply_html ist ausschließlich der Eingabename der Compose-Anfrage — wer in der Antwort danach sucht, findet nichts und hält einen intakten Entwurf fälschlich für leer (geprüft am 2026-08-19). Der Entwurfs-HTML-Inhalt wird serverseitig bereinigt: E-Mail-Inhalte als Tabellen mit direkt am Element notierten Styles aufbauen und Breiten als CSS angeben.
  • Dokumente, ERP, Messaging, Analytics: Für nahezu jede Fachdomäne existiert ein API-Modul — die aktuelle Liste liefert die Discovery aus Abschnitt 1.

Arbeitszeitnachweise revisionssicher importieren

Monatliche Arbeitszeit-PDFs werden als Beweiskette aus Quelldokument, Import und Zeiterfassungs-Einträgen behandelt:

  1. Lesen Sie zuerst den vorhandenen Zeitraum und klären Sie Überlappungen oder mehrdeutige Datumszeilen.
  2. Laden Sie das PDF über den in der Live-Spezifikation ausgewiesenen Dokumenten-Upload hoch.
  3. Nutzen Sie die Vorschau des Arbeitszeiten-Batchimports, bevor Sie mit einem deterministischen Idempotenzschlüssel schreiben. Wiederholungen dürfen keine Dubletten erzeugen.
  4. Korrekturfassungen ersetzen den Altstand revisionssicher und löschen ihn nicht.
  5. Verknüpfen Sie jede Zielzeile über DocumentLinks mit ihrem PDF. Beide Richtungen müssen in der Oberfläche navigierbar sein; die Verknüpfungen gehören auch in den Steuerfrist-Export.

Ein Maschinenschlüssel mit hr.presence:read ist absichtlich nur für Anwesenheits-Lesewege freigeschaltet. Der schreibende Import benötigt die in der Live-Spezifikation angegebene Benutzer-Authentifizierung und CSRF-Sicherung.

Postfach lesen — standardmaessig pseudonymisiert

Die Postfach-Endpunkte unter /api/imap/… geben personenbezogene Angaben standardmaessig nur pseudonymisiert heraus: Absender, Empfaenger, Betreff und Nachrichtentext — auch Namen und Adressen dritter Personen im Fliesstext — sowie die Namen von Anhaengen. Der Rohkopf einer Nachricht wird gar nicht uebermittelt, Anhangs-Inhalte nur mit einer ausdruecklich vergebenen Sonderberechtigung, die im Einzelfall und mit schriftlicher Begruendung erteilt wird.

Jede Antwort weist aus, welcher Weg gewaehlt wurde (meta.pseudonymisiert und meta.pseudonymisierung.quelle). Werten Sie dieses Feld aus, bevor Sie einen Wert als echt behandeln.

Echte Werte fuer einen tatsaechlichen Versand — etwa die Anrede einer Antwortmail — holen Sie nicht beim Lesen, sondern zweckgebunden ueber POST /api/pseudonymizer/depseudonymize. Schlaegt die Pseudonymisierung fehl, antwortet die Schnittstelle mit geschwaerzten Feldern, niemals mit Klartext.

8. Das Maximum herausholen — Kurzrezepte

Bank-Transaktions-CSV sicher importieren

Den Upload-Endpunkt in der authentifizierten Live-OpenAPI über importBankStatement und die zugehörigen Lese-/Nachweisoperationen entdecken, nicht aus einer alten Anleitung übernehmen. Vor dem Schreiben Bewegungszahl und Summe in kleinsten Währungseinheiten lesen, denselben Upload als dryRun prüfen und beim Import einen stabilen Idempotenzschlüssel verwenden. Nachher Zahl, Summe, Importstatus und Provenienzkanten erneut lesen; ein unveränderter Re-Import darf weder Bewegungen noch Kanten duplizieren.

Gegenparteiname und IBAN werden tenantgebunden vor dem Speichern pseudonymisiert; der Verwendungszweck bleibt für Abgleich und Kontierung bewusst geschäftskritischer Klartext. field_status weist dies je Feld aus. Das aufbewahrte CSV-Quelldokument wird über DocumentLinks mit jeder Bewegung und deren abgeleiteter Buchung verbunden. Fehlt ein Einzelbeleg, ist das CSV selbst die Quelle.

  1. Erst Sandbox, dann Produktion: kostenlose Wegwerf-Umgebung provisionieren, Integration bauen, erst danach echte Zugangsdaten nutzen.
  2. Typisierte Clients generieren (/api/docs/sdk/…) statt Requests von Hand zu bauen — weniger Drift, wenn sich die API weiterentwickelt.
  3. Mit Trial + Credits starten: Testphase aktivieren, die sofort verfügbaren Credits für KI-Funktionen nutzen, per plan-change-preview den Zielplan kalkulieren, dann konvertieren.
  4. Bundles statt Einzel-Apps: ein Branchen-Bundle aktiviert die passende App-Kombination samt Verdrahtung in einem Aufruf.
  5. Verbrauch beobachten: usage/quota regelmäßig lesen und Kontingente per Add-on gezielt erweitern statt pauschal zu überdimensionieren.
  6. Fehler ernst nehmen: auf code verzweigen, requestId loggen, 429 mit Backoff behandeln.
  7. Die Kommandozeile nutzen: das offizielle CLI itt (curl -fsSL ${ITT_ORIGIN}/api/docs/cli/itt -o itt && chmod +x itt) bündelt Anmeldung (persönlicher Token), Konto-Überblick, Apps/Angebote/ Bundles/App-State, Workspace-Manifeste (itt workspace), PII-Pseudonymisierung (itt pseudo), einen MCP-Server-Modus für KI-Agenten (itt mcp serve) und einen generischen, OpenAPI-gestützten itt api-Modus — Details im Beitrag „CLI ‚itt' — Apps & API von der Kommandozeile" in dieser Kategorie. Token-Scopes werden serverseitig erzwungen: reine read-Token können nie schreiben. Seit v1.3 gibt es zusätzlich den Browser-Session-Login (itt login --session, E-Mail + Passwort, Cookie-Session mit automatischem CSRF) — gedacht für Umgebungen hinter einem HTTP-Basic-Gate, in denen Bearer-Token den Authorization-Header nicht verwenden können (--edge-basic user:pass). Seit v1.4.1 sind die täglichen Prüfwege direkt kuratiert: itt docs list|archive, itt accounting chart|receipt-links und itt members list --tenant …. Mandantengebundene API-Keys benötigen dafür files:read, accounting.journal:read beziehungsweise users:read; ein reiner Lese-PAT darf dieselben GET-Routen verwenden. Die gespeicherte Mandantenbindung des Credentials ist maßgeblich, ein Fremdmandant wird mit 403 abgewiesen. Keiner dieser Scopes erlaubt einen Schreibzugriff.

Kunden-Setup gemeinsam mit einem Chat-Agenten

Ein Chat-Agent arbeitet ausschließlich mit einem kurzlebigen, auf den Kunden und dessen Mandanten begrenzten persönlichen Token — niemals mit einem Owner- oder Admin-Token. Lesende Übersichten, Spezifikation, Plan-, App-, Bundle- und Workspace-Diffs benötigen read; Änderungen benötigen zusätzlich write und die normale Berechtigung des Kunden.

Chat-Text ist immer untrusted Eingabe: Der Agent übernimmt ihn nicht in eine Shell, sondern erzeugt validierte Parameter. Vor jeder Änderung zeigt er den genauen Befehl ohne Zugangsdaten, erklärt die Wirkung und wartet auf eine neue Bestätigung. Kostenpflichtige, löschende oder zurückbauende Schritte brauchen eine gesonderte Bestätigung. DB-/FTP-Zugangsdaten und Server-Secrets werden über diese Kundenoberfläche weder angezeigt noch konfiguriert.

Während der Demo können Apps, Bundles und Einstellungen ohne Einzelrechnungen erprobt werden. Die Plattform besitzt Workspace-Konfiguration und eine Trial-Konvertierungs-API. Der heutige Convert ändert jedoch nur den Abo-Status; ein atomarer CLI-Ablauf, der das finale Setup bepreist und garantiert genau eine Rechnung erzeugt, fehlt noch. Bis Preview und idempotente Sammelkonvertierung verfügbar sind, wird der bezahlte Abschluss an einen Menschen übergeben und nicht durch mehrere Einzelaufrufe simuliert.

9. Kontakt

Fragen zur API, zu Plänen oder zu Integrationen: über das Kontaktformular auf it-tremmel.de oder direkt im Support-Bereich Ihres Kontos.

App installieren

Installieren Sie die App für schnelleren Zugriff und Offline-Nutzung.