Authentification

Chaque requête vers POST /v1/search est authentifiée avec une clé d’API envoyée dans l’en-tête x-api-key.

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "coffee makers" }'

Obtenir une clé

Créez et gérez vos clés dans le tableau de bord. Vous pouvez détenir plusieurs clés par compte (par exemple une par environnement) et en désactiver n’importe laquelle à tout moment. Chaque clé porte sa propre limite de débit, dérivée de votre plan.

Gardez vos clés secrètes

Traitez une clé d’API comme un mot de passe — ne l’envoyez que depuis du code côté serveur, ne l’intégrez jamais dans un navigateur ou une application mobile. Faites tourner une clé depuis le tableau de bord si elle fuite.

Erreurs d’authentification

HTTP	error	Signification
401	missing_api_key	Aucun en-tête x-api-key n’a été envoyé.
401	unknown_api_key	La clé n’existe pas.
403	inactive_api_key	La clé a été désactivée.
403	account_blocked	Le compte est suspendu.

Voir Erreurs & nouvelles tentatives pour le modèle d’erreur complet et les codes que vous devriez réessayer.