Authentification

Securisez les requetes API avec des cles Parsurai et comprenez les erreurs d'authentification.

L'API authentifie les requetes avec des cles API. Envoyez la cle dans le header X-API-Key.

Votre premiere cle

La premiere cle est emise lorsque vous verifiez votre adresse e-mail. L'inscription cree le compte mais aucune cle: suivez le lien du message de verification, et la page de confirmation affiche la cle une seule fois. Elle n'est jamais reaffichee, enregistrez-la donc avant de quitter cette page.

Tant que l'adresse n'est pas verifiee, chaque endpoint authentifie repond 428 email_verification_required. Si vous perdez la cle, creez-en une nouvelle dans Dashboard > Parametres > API Keys — l'ancienne reste valide jusqu'a ce que vous la supprimiez.

Format de cle API

Les nouvelles cles sont generees avec le prefixe sk_live_ et un secret aleatoire URL-safe. Seul un court prefixe est stocke pour affichage; la cle complete en clair n'est affichee qu'une seule fois.

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

N'incluez jamais de cles API dans JavaScript navigateur, bundles mobiles, depots publics ou logs.

Variable d'environnement

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"]

Gestion des cles

Creez et supprimez les cles actives dans Dashboard > Parametres > API Keys. Limites par offre:

Offre	Cles API actives
Free	1
Hobby	1
Starter	2
Pro	3
Business	10

Creer une nouvelle cle n'invalide pas les cles existantes. Supprimez une cle pour la revoquer immediatement.

Erreurs d'authentification

Statut HTTP	Code d'erreur	Cause
`401`	`invalid_api_key`	Header absent, mal forme, inactif ou inconnu
`402`	`inactive_subscription`	L'abonnement du compte n'est pas actif
`402`	`feature_not_in_plan`	La fonction demandee n'est pas incluse dans l'offre actuelle
`428`	`email_verification_required`	L'adresse e-mail du compte est en attente de verification
`429`	`quota_exceeded`	Le quota mensuel d'extractions est epuise

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

Checklist securite

Stockez les cles dans des variables d'environnement ou un gestionnaire de secrets.
Utilisez les cles uniquement cote backend/serveur.
Supprimez immediatement les cles lorsque l'acces doit etre revoque.
Surveillez l'usage via GET /v1/usage et les alertes dashboard.