Authenticatie

Elk verzoek aan POST /v1/search wordt geauthenticeerd met een API-sleutel die in de x-api-key-header wordt meegestuurd.

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" }'

Een sleutel ophalen

Maak en beheer sleutels in het dashboard. Je kunt meerdere sleutels per account aanhouden (bijv. één per omgeving) en elke sleutel op elk moment deactiveren. Elke sleutel heeft zijn eigen rate limit, afgeleid van je plan.

Houd sleutels geheim

Behandel een API-sleutel als een wachtwoord — stuur hem alleen vanuit server-side code, sluit hem nooit in in een browser of mobiele app. Roteer een sleutel via het dashboard als hij lekt.

Auth-fouten

HTTP	error	Betekenis
401	missing_api_key	Er werd geen x-api-key-header meegestuurd.
401	unknown_api_key	De sleutel bestaat niet.
403	inactive_api_key	De sleutel is gedeactiveerd.
403	account_blocked	Het account is geschorst.

Zie Fouten & retries voor het volledige foutmodel en de codes die je moet opnieuw proberen.