Zum Inhalt springen
TurnitPass
EntwicklerAPI v1
API-Schlüssel erstellen
Dokumentation durchsuchen

EntwicklerAuthentifizierung

Mit Bearer-API-Schlüsseln authentifizieren

Entwickler-Anfragen erfordern API-Schlüssel, die über den TurnitPass-Arbeitsbereich generiert werden.

REST API v1

Auth console

API-Schlüssel nicht im Browser halten.

TurnitPass-API-Aufrufe nutzen einen arbeitsbereichseigenen Bearer-Schlüssel. Der Schlüssel gehört in serverseitigen Code. Erstellen, Rotieren, Widerrufen und Nutzung bleiben im Dashboard.

Schlüsselleitplanken

Zugang sicher halten

Nur Server

Schlüssel von Backend-Routen, Workern, Jobs oder geschützten Serveraktionen senden.

Einmal angezeigt

Den erzeugten Schlüssel sofort kopieren und im Secret-Store ablegen.

Sicher rotieren

Den Ersatzschlüssel ausrollen, bevor der alte Produktionsschlüssel widerrufen wird.

Kontobezogen

Nutzung läuft auf Wortguthaben und Abrechnung des Arbeitsbereichs zusammen.

Bearer-Anfrage

Header-Vertrag

Standardmäßig privat
request
Bearer
fetch('https://turnitpass.com/api/v1/humanize', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer tp_live_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ text: draft, language: 'en' })
})
Auth fehlgeschlagen
failed auth
401
{
  "error": "Invalid or revoked API key.",
  "code": "invalid_api_key"
}
01Im Arbeitsbereich erzeugen
02In Secrets speichern
03Vom Server aufrufen
04Rotieren oder widerrufen

API-Schlüssel

Senden Sie den Header `Authorization: Bearer tp_your_api_key` mit jeder Anfrage. Schlüssel werden bei der Erstellung nur einmal angezeigt und können jederzeit im Arbeitsbereich widerrufen werden.

Authorization header
Bearer
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json

POST /api/v1/humanize
Schlüssel werden bei der Erstellung einmal gezeigt und können ohne Änderung der Google-Anmeldung widerrufen werden.

Managing keys

01

Erstellen

Einen benannten Schlüssel erzeugen und sofort kopieren.

02

Widerrufen

Sofort deaktivieren. Widerrufene Schlüssel können keine neuen Anfragen authentifizieren.

03

Ratenlimits

Jeder Schlüssel kann unabhängig begrenzt werden, die Nutzung läuft auf das Konto zusammen.

04

Abrechnung

Alle Schlüssel teilen Wortguthaben und Abo-Limits des Kontos.

Arbeitsbereichseigen

Key lifecycle

1

Benannten Schlüssel anlegen

Einen Namen wählen, der Umgebung oder Fläche beschreibt, etwa Production backend oder Staging worker.

2

Einmal in den Secret-Store kopieren

TurnitPass zeigt den Schlüssel nur bei der Erstellung. In Deploy-Provider, CI oder .env speichern.

3

Nutzung über Status und Abrechnung sehen

Alle Schlüssel teilen das Wortguthaben. Namen helfen, die aktive Integration zu finden.

4

Vor dem Widerruf rotieren

Ersatzschlüssel erzeugen, ausrollen, Traffic prüfen, dann den alten Schlüssel widerrufen.

Environment setup

TurnitPass-Schlüssel als serverseitige Secrets speichern. Die Beispiele nutzen generische Namen für Next.js, Workers, Jobs oder jedes Backend.

.env
server only
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Lokale Entwicklung
.env.local oder lokaler Secret-StoreEinen Nicht-Produktionsschlüssel mit kleinem Wortbudget und klarem Namen verwenden.
Preview-Deploys
Staging-SchlüsselPreview-Traffic trennen, damit Tests keine Produktionsnutzung verbrauchen.
Produktion
Nur Backend-SecretDen Schlüssel nur aus vertrauenswürdigem Servercode lesen, nie an den Browser geben.

Security best practices

Nur serverseitig
Keine Schlüssel im BrowsercodeSchlüssel aus Backend-Diensten, Jobs oder geschützten Serverrouten verwenden.
Umgebungsvariablen
TURNITPASS_API_KEY verwendenKeine Live-Schlüssel in Quellcode oder Client-Bundles schreiben.
Schlüssel rotieren
Ersatz vor dem Widerruf anlegenGetrennte Schlüssel für Produktion, Staging und Entwicklung.
Bei Kompromittierung
Sofort widerrufenBei Leak einen neuen Schlüssel im Arbeitsbereich erzeugen.

Authentication errors

Header fehlt
Kein Authorization-Header
Falsches Format
Header beginnt nicht mit Bearer
Ungültiger Schlüssel
Nicht gefunden, widerrufen oder fehlerhaft
Zu viele Fehler
Wiederholte Auth-Fehler können ratenbegrenzt werden
401 response
JSON
{
  "error": "Invalid or revoked API key.",
  "code": "invalid_api_key"
}

Next steps

Schnellstart

Die erste Humanize-Anfrage senden.

API-Referenz

Endpunkte, Parameter und Antwortformate prüfen.

Als Nächstes in Ihren Workflow einbinden.Weiterlesen