Аутентификация в Love&Pay Crypto API

Love&Pay Crypto API использует несколько схем авторизации для обеспечения безопасности взаимодействия с API. В этом разделе описаны доступные схемы авторизации, процесс получения ключей и токенов, формат передачи данных, а также примеры запросов и обработка ошибок.

Схемы авторизации#

Для доступа к Love&Pay Crypto API необходимо использовать следующие схемы авторизации:

• V2ApiKey: Публичный ключ партнёра, который передаётся в заголовке x-api-key.
• V2Signature: Подпись запроса, которая передаётся в заголовке x-signature.
• V2Timestamp: Время запроса в миллисекундах Unix, передаётся в заголовке x-timestamp.

Получение ключей и токенов#

Публичный ключ (apiKey) можно получить в личном кабинете Love&Pay в разделе «Доступ к API».

Передача данных#

Для каждого запроса к API необходимо передавать следующие заголовки:

• x-api-key: Публичный ключ партнёра.
• x-signature: Подпись запроса, сгенерированная с использованием алгоритма HMAC-SHA256.
• x-timestamp: Время запроса в миллисекундах Unix.

Формат подписи запроса#

Подпись запроса (x-signature) формируется следующим образом:

1. Создайте строку для подписи, объединяя следующие элементы:

   • HTTP метод (например, GET, POST)
   • Путь запроса (например, /api/v2/crypto/networks)
   • Время запроса (x-timestamp)
   • SHA256-хеш тела запроса (если тело пустое, используйте пустую строку)
   • Строка привязки (BIND), если используется

2. Сгенерируйте HMAC-SHA256 подпись в hex формате по полученной строке, используя секретный ключ.

Пример запроса#

curl -X GET https://api.prod.loveandpay.io/api/v2/crypto/networks \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-signature: YOUR_GENERATED_SIGNATURE" \
  -H "x-timestamp: CURRENT_TIMESTAMP"

Типичные ошибки#

Ошибка 401 Unauthorized#

Возникает, если предоставлены неверные или отсутствуют заголовки авторизации. Проверьте:

• Правильность x-api-key.
• Корректность x-signature.
• Актуальность x-timestamp (должно быть в пределах ±5 минут от текущего времени).

Ошибка 403 Forbidden#

Возникает, если у вас нет прав доступа к запрашиваемому ресурсу. Убедитесь, что ваш ключ имеет необходимые разрешения и доступ к API.