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-Idkann die Bindung nur bestätigen, sofern der jeweilige Endpunkt den Header nicht ausdrücklich verlangt. Beim mandantenlosen Pseudonymizer-Admin-Schlüssel stehttenant_idverpflichtend 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}oderGET /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-Agentspielt keine Rolle; ein nicht pruefbarer Maschinen-Zugang macht die Anfrage nur strenger. - Die Ablehnungen sind unterscheidbar — bitte auf
codeverzweigen: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).429bleibt 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/subscribestartet ein Abo über einen Zahlungsanbieter (z. B. Stripe oder PayPal). Geldbewegende Aufrufe (subscribe,quota/purchase-addon,refunds) akzeptieren einenIdempotency-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äterPOST /api/billing/trial/convert. - Einsehen:
GET /api/billing/my-planundGET /api/billing/subscriptionzeigen 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 überGET /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 überGET /api/billing/invoices/{id}/pdf; Korrekturen (Storno/Gutschrift) haben eigene Endpunkte. - Verbrauch & Kontingente:
GET /api/billing/usage/current,GET /api/billing/quota, Erweiterungen überPOST /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}/previewzeigt vorab, welche Apps hinzukämen, was schon vorhanden ist und wie der Plan-Status je App aussieht.- Alles auf einen Blick:
GET /api/me/overviewliefert 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):
-
Schaufenster, öffentlich:
GET /api/agents/catalog— Zugangspass (net_minor_units,vat_percentals ganze Zahl,gross_minor_units,period_days,auto_renew: false), Nutzungspreise in Credits (metering.rate_card), Kontingent-Vertrag (quota), Scopes und allecapabilities[]mit Routenmuster und Pflicht-Scope. Mit Agent-Token liefert derselbe Aufruf zusätzlich das eigeneentitlement(Zugangs-Uhr, Scopes,quota.used/remaining) — streng mandantenbezogen. -
Kauf als bewusste Wahl in zwei Schritten:
POST /api/agent-auth/self-service/ordersmitIdempotency-KeyundX-Tenant-Idgleichtenant_idim Body →order_id,claim_token, Betrag, Statuspayment_pending(nichts wird belastet, kein Schlüssel existiert). Ohne Idempotenzschlüssel: 422idempotency_key_required. Bezahlen kann der Agent selbst:POST /api/acp/checkout_sessionsmitX-Tenant-Idgleich dem Mandanten der Bestellung und genau einem Artikelagent_access_pass:<order_id>(Menge 1,buyer.email), danachPOST …/checkout_sessions/{id}/completemitpayment_data.providerbank_transfer(Überweisungsdaten in der Antwort, Zahlung gilt erst nach Verbuchung durch den Händler als eingegangen) oderx402(sofort verbucht). Die Antwort nennt diepayment_transaction_id; der Betrag ist exakt der auf der Bestellung gespeicherte.GET /api/agent-auth/self-service/orders/{id}zeigtpayment.status(unpaid | pending | settled) und trägt die Zahlungs-Id innext_stepein, sobald sie verbucht ist — nichts läuft außerhalb der API. ErstPOST /api/agent-auth/self-service/orders/{id}/issuemitclaim_tokenund dieser verbuchten, mandantengebundenen Zahlung über den exakten Betrag gibt den Token einmalig heraus. Jede Ausgabe trägtDocumentLinks-Kanten Bestellung → Zahlung und Bestellung → Token. -
Nutzen:
Authorization: Bearer itt_agt_…ausschließlich auf den Routen der Agenten-Richtlinie (GET /api/erp/*,/api/search,/api/reporting/*…). Fremde Routen → 403agent_scope_forbidden, fehlender Scope → 403agent_scope_insufficient. -
Kontingent:
GET /api/agent-auth/self-service/usagezeigtquota.budget/used/remainingje Token und Zugangsperiode. Ist das Budget erschöpft, antwortet jede Route mit 429rate_limit_exceeded,Retry-After(Sekunden bis Periodenende),X-Agent-Quota-Used,X-Agent-Quota-BudgetundX-Agent-Error: agent_quota_exhausted; abgewiesene Aufrufe verbrauchen nichts. -
Werkzeuge laden (LLM-Discovery):
GET /api/agents/toolsliefert 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). -
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 alsx-itt-pricingan jeder bepreisten Operation der OpenAPI-Spezifikation und in/.well-known/agents.json(pricing,authentication.tokenIssuance.selfService);/.well-known/ai-plugin.jsonund/.well-known/openapi.jsonsind echte Dokumente, unbekannte/.well-known-Pfade antworten mit JSON-404. Ist beim MandantenAGENT_USAGE_METERINGeingeschaltet, wird jeder erfolgreiche Aufruf einer Katalog-Route als eine Verbrauchszeile gezählt (GET /api/agent-billing/usage), und jede Zeile trägt eineDocumentLinks-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üfungGET /api/ai/providers/healthund per einwilligungspflichtiger Fernsteuerung (/api/remote-steering/…: Sitzungen, Kommandos, Live-Events). Für agentengeführte Abnahmeläufe liefertGET /api/remote-steering/sessions/{id}/commandsden PASS/FAIL-Zustand jedes Schrittes aus dem dauerhaften Kommando-Ledger zurück, undPOST …/sessions/{id}/transport-urlprägt die einmalige SSE-Nonce für den Verbindungsaufbau (das langlebige Transport-Token steht nie in der Stream-URL). Klick-/Warte-Ziele adressierendata-testidexakt (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 liefertGET /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_versionlehnt veraltete Pläne ab. - Chat-/Sprach-Composer, Befehls-Choreographie, „wer steuert gerade":
Plattform-KIliefertSteeringComposer(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 BefehlsfolgecreateCommandChoreoRunner/ChoreoStepList(je Schritt geplant/läuft/fertig/fehlgeschlagen/abgelehnt/abgebrochen, abbrechbar, destruktive Schritte fragen erneut) undSteeringControlBadge(eine Antwort: Sie · Operator · KI-Agent · Choreographie). Apps ohne eigene Befehle tragen den MindestvertragcreateMinimalSteering(open+set-filter) aus@it-tremmel.de/platform-steerable; Konvention und Proben:docs/steering-mindestvertrag.md. - PII-Pseudonymisierung:
POST /api/pseudonymizer/pseudonymizeersetzt personenbezogene Daten in beliebigem JSON durch umkehrbare Tokens (verschlüsselt je Mandant),…/depseudonymizestellt sie wieder her — ideal, bevor Daten an Dritt-KI oder externe Tools gehen. Ein mandantengebundener API-Key verwendet ausschließlich seine gespeicherte Bindung; ein optionalerX-Tenant-Id-Header muss dazu passen. Der mandantenlose Admin-Key benötigt bei beiden Aufrufentenant_idin 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, undGET /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 mitGET /api/communication/email-drafts?include_terminal=1— Zustellung wird anstatusundsent_atdieser Liste abgelesen, nie an der Einzelabfrage. Der HTML-Inhalt steht in dieser Liste im Feldbody_htmlund kommt vollständig mit, ohne zusätzlichen Parameter;reply_htmlist 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:
- Lesen Sie zuerst den vorhandenen Zeitraum und klären Sie Überlappungen oder mehrdeutige Datumszeilen.
- Laden Sie das PDF über den in der Live-Spezifikation ausgewiesenen Dokumenten-Upload hoch.
- Nutzen Sie die Vorschau des Arbeitszeiten-Batchimports, bevor Sie mit einem deterministischen Idempotenzschlüssel schreiben. Wiederholungen dürfen keine Dubletten erzeugen.
- Korrekturfassungen ersetzen den Altstand revisionssicher und löschen ihn nicht.
- Verknüpfen Sie jede Zielzeile über
DocumentLinksmit 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.
- Erst Sandbox, dann Produktion: kostenlose Wegwerf-Umgebung provisionieren, Integration bauen, erst danach echte Zugangsdaten nutzen.
- Typisierte Clients generieren (
/api/docs/sdk/…) statt Requests von Hand zu bauen — weniger Drift, wenn sich die API weiterentwickelt. - Mit Trial + Credits starten: Testphase aktivieren, die sofort
verfügbaren Credits für KI-Funktionen nutzen, per
plan-change-previewden Zielplan kalkulieren, dann konvertieren. - Bundles statt Einzel-Apps: ein Branchen-Bundle aktiviert die passende App-Kombination samt Verdrahtung in einem Aufruf.
- Verbrauch beobachten:
usage/quotaregelmäßig lesen und Kontingente per Add-on gezielt erweitern statt pauschal zu überdimensionieren. - Fehler ernst nehmen: auf
codeverzweigen,requestIdloggen, 429 mit Backoff behandeln. - 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ütztenitt api-Modus — Details im Beitrag „CLI ‚itt' — Apps & API von der Kommandozeile" in dieser Kategorie. Token-Scopes werden serverseitig erzwungen: reineread-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 denAuthorization-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-linksunditt members list --tenant …. Mandantengebundene API-Keys benötigen dafürfiles:read,accounting.journal:readbeziehungsweiseusers: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.