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

Передавайте 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. Это не ключ идемпотентности.
curl "https://api.atomic.wallet/api/v1/project" \
  -H "x-api-key: $API_KEY"

Ошибки авторизации

HTTPКодКогда возникает
401MERCHANT_AUTH_REQUIREDКлюч отсутствует или неверен, указан неверный project header, окружение или IP не входит в разрешённый список.
403ACCOUNT_ACCESS_DENIEDУ аккаунта нет нужного доступа или функция отключена, например withdrawalsEnabled=false.

Безопасность ключа