Authentifizierung

Sichern Sie API-Anfragen mit Parsurai-API-Schluesseln und verstehen Sie Authentifizierungsfehler.

Die API authentifiziert Anfragen ueber API-Schluessel. Senden Sie den Schluessel im Header X-API-Key.

Ihr erster Schluessel

Der erste Schluessel wird ausgestellt, sobald Sie Ihre E-Mail-Adresse bestaetigen. Die Registrierung legt das Konto an, aber keinen Schluessel: Folgen Sie dem Link in der Bestaetigungs-E-Mail, und die Bestaetigungsseite zeigt den Schluessel einmalig an. Er wird nie erneut angezeigt; speichern Sie ihn, bevor Sie die Seite verlassen.

Bis die Adresse bestaetigt ist, antwortet jeder authentifizierte Endpunkt mit 428 email_verification_required. Falls Sie den Schluessel verlieren, erzeugen Sie unter Dashboard > Einstellungen > API Keys einen neuen — der alte bleibt gueltig, bis Sie ihn loeschen.

API-Schluesselformat

Neue Schluessel werden mit dem Praefix sk_live_ und einem URL-sicheren Zufallsgeheimnis erzeugt. Fuer die Anzeige wird nur ein kurzer Praefix gespeichert; der vollstaendige Klartextschluessel wird nur einmal angezeigt.

POST /v1/extract HTTP/1.1
Host: api.parsurai.com
X-API-Key: sk_live_your_actual_key_here
Content-Type: application/json

Nutzen Sie API-Schluessel nie in Browser-JavaScript, mobilen App-Bundles, oeffentlichen Repositories oder Logs.

Umgebungsvariable

PARSURAI_API_KEY=sk_live_your_actual_key_here

Node.js

const apiKey = process.env.PARSURAI_API_KEY;

Python

import os

api_key = os.environ["PARSURAI_API_KEY"]

Schluesselverwaltung

Erstellen und loeschen Sie aktive Schluessel unter Dashboard > Einstellungen > API Keys. Tariflimits:

Tarif	Aktive API-Schluessel
Free	1
Hobby	1
Starter	2
Pro	3
Business	10

Ein weiterer Schluessel invalidiert bestehende Schluessel nicht. Loeschen Sie einen Schluessel, um ihn sofort zu widerrufen.

Authentifizierungsfehler

HTTP-Status	Fehlercode	Ursache
`401`	`invalid_api_key`	Header fehlt, ist fehlerhaft, inaktiv oder unbekannt
`402`	`inactive_subscription`	Das Kontoabonnement ist nicht aktiv
`402`	`feature_not_in_plan`	Die angeforderte Funktion ist im aktuellen Tarif nicht enthalten
`428`	`email_verification_required`	Die E-Mail-Adresse des Kontos ist noch nicht verifiziert
`429`	`quota_exceeded`	Das monatliche Extraktionskontingent ist erschoepft

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid or inactive API key."
  }
}

Sicherheitscheckliste

Speichern Sie Schluessel in Umgebungsvariablen oder einem Secret Manager.
Nutzen Sie Schluessel nur in Backend-/Server-Code.
Loeschen Sie Schluessel sofort, wenn Zugriff widerrufen werden soll.
Ueberwachen Sie Nutzung ueber GET /v1/usage und Dashboard-Warnungen.