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

Lumo B2B API использует API-ключи для аутентификации запросов.

API-ключ выдаётся при подключении компании к платформе. Свяжитесь с менеджером в Telegram.

После подключения вы получите:

• Email и пароль для входа
• Первичный API-ключ
• Доступ к личному кабинету

Рекомендуемый способ — заголовок X-API-Key:

curl -X GET 'https://b2b.lumowallet.io/wallets/balance' \
  -H 'X-API-Key: lb2b_5f7f1f7b7f034dbf81b0b8b8d7c0b9f1'

Также поддерживаются:

• Authorization: Bearer <api-key>
• Query-параметр ?api_key=<api-key> (не рекомендуется)

Перевыпустите ключ через эндпоинт regenerate-key:

curl -X POST 'https://b2b.lumowallet.io/auth/company/regenerate-key' \
  -H 'X-API-Key: YOUR_CURRENT_API_KEY'

⚠️ Важно: Предыдущий ключ становится недействительным.

Доступ к API ограничен списком разрешённых IP-адресов. Для добавления IP свяжитесь с менеджером.

Запросы с неавторизованных IP получат ошибку:

{
  "statusCode": 403,
  "message": "IP address not whitelisted",
  "error": "Forbidden"
}

• Храните API-ключ в безопасном месте (env-переменные, secrets manager)
• Не передавайте ключ в URL или логах
• Периодически ротируйте ключи
• Используйте HTTPS для всех запросов