Die vollständige Referenz bleibt auf Englisch, damit Methodennamen, Fehlermeldungen und technische Begriffe exakt mit den veröffentlichten Paketen übereinstimmen. Diese Seite führt deutschsprachige Teams durch den empfohlenen Einstieg.
Oberfläche auswählen
| Anwendungsfall | Empfohlene Oberfläche |
|---|---|
| Produktivdienst in einer beliebigen Sprache | API v1 |
| Node.js- oder TypeScript-Dienst | TypeScript SDK |
| Terminal, Skripte oder CI | CLI |
| Überwachte Lesezugriffe aus einem vertrauenswürdigen AI-Host | MCP-Server |
| Bestehende Integration mit API v0 | Migration zu API v1 |
Empfohlener Einstieg
- Entscheide, ob die Integration einer Person oder einem dauerhaft betriebenen Dienst gehört.
- Nutze für lokale Entwicklung einen Personal Token und für produktive Prozesse einen Service Account.
- Vergib nur die wirklich benötigten Scopes. Die Scope-Rezepte geben sichere Ausgangspunkte vor.
- Prüfe mit
GET /workspace, ob Token, Region und Workspace zusammenpassen. - Implementiere begrenzte Timeouts, Pagination, Wiederholungen, Idempotency Keys und
If-Match, bevor die Integration Kundendaten verändert. - Arbeite vor dem Start die Production-Go-live-Checkliste ab.
CLI und Browser-Login
npm install --global @teamgrid/cli@1.0.6
teamgrid auth login
teamgrid auth status --check
teamgrid workspaceDer Browser-Login nutzt eine lokale Loopback-Verbindung und speichert den Token im
Betriebssystem-Schlüsselbund. --no-browser ist kein Device Flow. Für CI und Server darf kein
interaktiver Browser-Login verwendet werden; dort gehört ein Service-Account-Token in einen Secret
Manager. Alle Einzelheiten stehen unter CLI Browser Login.
Hilfe und Sicherheit
Übermittle an den Support nur Statuscode, stabilen Fehlercode, Request-ID, Zeitpunkt und Region. Teile niemals Token, Browser-Freigabe-URL, PKCE-Werte, Webhook-Secrets, Upload- oder Download-Intents, Umgebungsvariablen oder ungeschwärzte Kundendaten.
Nutze bei Fehlern die Troubleshooting-Anleitung und prüfe den TeamGrid-Status.