Аутентификация

Каждый запрос к POST /v1/search аутентифицируется API-ключом, отправленным в заголовке 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" }'

Получение ключа

Создавайте ключи и управляйте ими в панели управления. Вы можете держать несколько ключей на аккаунт (например, по одному на окружение) и деактивировать любой из них в любое время. Каждый ключ несёт собственный лимит частоты, производный от вашего тарифа.

Ошибки аутентификации

HTTP	`error`	Значение
401	`missing_api_key`	Заголовок `x-api-key` не был отправлен.
401	`unknown_api_key`	Ключ не существует.
403	`inactive_api_key`	Ключ был деактивирован.
403	`account_blocked`	Аккаунт приостановлен.

Полную модель ошибок и коды, которые следует повторять, см. в Ошибки и повторы.