Перейти к содержимому
Последнее обновление

Platform API

Vilna Platform API — это RESTful-сервис для мониторинга блокчейнов, управления кошельками и обработки платежей. Он предоставляет единый интерфейс для работы с множеством блокчейн-сетей, используя стандарты CAIP для идентификации сетей и активов.

Полная документация по эндпоинтам доступна в справочнике Platform API.

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

Все запросы требуют API-ключ в заголовке X-Api-Key. Подробности см. в руководстве по аутентификации.

Базовый URL

https://{namespace}.vilna.app

Пространство имён предоставляется при получении доступа к API. Для запроса доступа обратитесь на support@vilna.io.

Ресурсы API

Данные блокчейнов

  • Blockchains — запрос поддерживаемых сетей, активация и деактивация цепочек, управление конфигурацией
  • Blocks — получение данных блоков по сети и номеру блока
  • Tokens — поиск метаданных активов (название, символ, десятичные знаки) по сети и адресу контракта

Управление адресами

  • Addresses — отслеживание внешних и HD-производных адресов в различных сетях
  • Public keys — регистрация расширенных публичных ключей HD-кошельков и деривация новых адресов

Финансовые данные

  • Balances — запрос текущих балансов токенов по отслеживаемым адресам
  • Transactions — поиск деталей и истории транзакций с фильтрацией и сортировкой
  • Activity — поток изменений балансов (переводы, одобрения) по всем отслеживаемым адресам

Платежи

  • Invoices — создание и управление крипто-инвойсами с автоматическим определением оплаты

Уведомления

  • Notification channels — настройка вебхуков и Telegram-оповещений, просмотр логов доставки

Инструменты

  • Simulation — предварительный просмотр эффектов EVM-транзакций (изменения балансов, оценка газа) перед отправкой
  • Preview — просмотр данных блока для заданной сети и номера блока

См. также

SDK и инструменты

  • TypeScript: @vilna/sdk — типизированный клиент с полной поддержкой типов OpenAPI
  • Любой язык: сгенерируйте клиент из спецификации OpenAPI с помощью таких инструментов, как openapi-generator
  • Management API: управление рабочими пространствами, проектами и ключами через Management API