Инструменты разработчика

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

Ресурсы для разработки и тестирования интеграции с Lumo B2B API.

Mock Server

Тестируйте API без реальных транзакций:

https://lumo.redocly.app/_mock/apis

Mock-сервер возвращает примеры ответов из OpenAPI-спецификации. Идеально для:

• Первичной разработки
• Unit-тестов
• CI/CD пайплайнов

Пример

curl -X POST 'https://lumo.redocly.app/_mock/apis/orders/prepare' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: test-key' \
  -d '{"qrCode": "https://qr.nspk.ru/test"}'

Staging окружение

Полнофункциональное тестовое окружение:

https://b2b-staging.lumowallet.io

Особенности:

• Реальная логика API
• Тестовые данные
• Отдельные API-ключи

Для получения доступа к staging свяжитесь с менеджером.

Replay Console

Интерактивная консоль прямо в документации:

1. Откройте API Reference
2. Выберите endpoint
3. Заполните параметры
4. Нажмите "Try it"

Replay поддерживает:

• Авторизацию через API-ключ
• Редактирование request body
• Просмотр response

OpenAPI Specification

Скачайте OpenAPI-спецификацию для генерации клиентов:

• OpenAPI YAML

Генерация клиента:

# JavaScript/TypeScript
npx @openapitools/openapi-generator-cli generate \
  -i https://lumo.redocly.app/apis/index.yaml \
  -g typescript-fetch \
  -o ./lumo-client

# Python
openapi-generator generate \
  -i https://lumo.redocly.app/apis/index.yaml \
  -g python \
  -o ./lumo-client

Postman Collection

Импортируйте OpenAPI-спецификацию в Postman:

1. Откройте Postman
2. File → Import
3. Вставьте URL: https://lumo.redocly.app/apis/index.yaml
4. Настройте переменную {{API_KEY}}

Webhook тестирование

Для тестирования webhooks используйте:

• webhook.site — временный endpoint для просмотра запросов
• ngrok — туннель к локальному серверу

Пример с ngrok:

# Запустите туннель
ngrok http 3000

# Обновите webhook URL
curl -X PATCH 'https://b2b-staging.lumowallet.io/auth/company/profile' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"webhookUrl": "https://abc123.ngrok.io/webhooks/lumo"}'

Логирование

Рекомендуемый формат логов:

const log = {
  timestamp: new Date().toISOString(),
  requestId: uuid(),
  endpoint: '/orders/prepare',
  method: 'POST',
  statusCode: 201,
  duration: 145,
  request: { qrCode: '...' },
  response: { id: '...', amountUsdt: 52.63 }
};

Мониторинг

Метрики для отслеживания: