Аутентификация
Передавайте API-ключ проекта в заголовке x-api-key.
Все запросы с API-ключом выполняются только по HTTPS. Ключ не нужен для /status и /health*.
Заголовки запроса
| Заголовок | Обязателен | Описание |
|---|---|---|
x-api-key | да | Ключ проекта (кроме /status и /health*). |
accept-language | нет | ru или en; локализует поле message в ошибках. |
x-project-id | нет | Проверка, что ключ принадлежит проекту. Другой проект этим заголовком не выбрать. |
x-request-id | нет | Correlation ID. Если не передан, сервер сгенерирует UUID. Это не ключ идемпотентности. |
Ошибки авторизации
| HTTP | Код | Когда возникает |
|---|---|---|
| 401 | MERCHANT_AUTH_REQUIRED | Ключ отсутствует или неверен, указан неверный project header, окружение или IP не входит в разрешённый список. |
| 403 | ACCOUNT_ACCESS_DENIED | У аккаунта нет нужного доступа или функция отключена, например withdrawalsEnabled=false. |