{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ru/get-started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Быстрый старт - первый запрос к Platform API","projectTitle":"Vilna Docs","description":"Создайте рабочее пространство и API-ключ, запросите балансы, зарегистрируйте адрес для мониторинга и настройте webhook-уведомления.","siteUrl":"https://docs.vilna.io","lang":"en-US","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-quickstart.png","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Vilna Documentation"},{"name":"og:image:width","content":"1200"},{"name":"og:image:height","content":"630"},{"name":"twitter:card","content":"summary_large_image"},{"name":"robots","content":"max-image-preview:large"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna Platform API monitors public blockchain activity, balances and invoices and delivers signed webhooks. It does not sign or broadcast transactions. VKS separately coordinates account setup, signer approvals and signing, retains signed results and can submit a complete transaction to a node. Node acceptance is not blockchain confirmation. Each API uses its own scoped credential in X-Api-Key. Workspace setup and VKS-key issuance start in the Dashboard.\n","details":{"content":"**Platform monitoring.** Platform observes merchant-controlled addresses,\nsupplied directly or derived from the merchant's extended public key (xPub).\nInvoices report incoming on-chain activity; they do not initiate transfers.\n\n**APIs and their credentials.**\n\n- Platform API (api.vilna.io) - monitor addresses and extended public keys, read\n  balances and transactions, reconcile incoming payments, create invoices, and\n  receive events.\n- Blockchain RPC (rpc.vilna.io) - JSON-RPC and gRPC node access across every\n  supported network behind one key.\n- Management API (mgmt.vilna.io) - published workspace, project, member and key\n  operations, with Dashboard bootstrap and credential grant limits.\n- VKS API (vks.vilna.io) - workspace signers, vaults, accounts, signing requests,\n  signed results and optional asynchronous send. Uses a Dashboard-issued VKS key\n  with vks:access; the public Management API has no VKS-key issuance route.\n\n**Pages with no markdown source**, so they cannot be linked below:\n\n- Product overview: https://docs.vilna.io/\n- All guides: https://docs.vilna.io/guides\n"},"excludeFiles":["legal/terms.md","legal/privacy.md","legal/cookies.md","@l10n/ru/legal/terms.md","@l10n/ru/legal/privacy.md","@l10n/ru/legal/cookies.md"],"sections":[{"title":"Getting Started","description":"What the platform is, how to make a first call, and answers to common questions","includeFiles":["get-started/quickstart.md","get-started/dashboard.md","get-started/core-concepts.md","get-started/members.md","get-started/faq.md"]},{"title":"API Reference","description":"Authentication, permissions, idempotency, errors, standards, and per-service endpoint documentation","includeFiles":["apis/authentication.md","apis/permissions.md","apis/idempotency.md","apis/errors.md","apis/standards.md","apis/networks.md","apis/platform/@v2/index.md","apis/platform/@v2/webhooks.md","apis/platform/@v2/api.yaml","apis/mgmt/index.md","apis/mgmt/api.yaml","apis/vks/index.md","apis/vks/api.yaml","apis/rpc/index.md","apis/rpc/json-rpc.md","apis/rpc/grpc.md"]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, and tooling","includeFiles":["guides/events.md","guides/channels.md","guides/tokens.md","guides/integration-patterns.md","guides/mcp.md","guides/simulation.md","guides/invoices.md","guides/vks.md"]},{"title":"Trust and custody","description":"The non-custodial model in plain terms","includeFiles":["legal/non-custodial.md"]},{"title":"Optional","description":"Background reading and release history","includeFiles":["get-started/blockchain-basics.md","changelog.md"]}]},"priority":0.9,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Главная","item":"https://docs.vilna.io/ru/"},{"@type":"ListItem","position":2,"name":"Начало работы","item":"https://docs.vilna.io/ru/get-started"},{"@type":"ListItem","position":3,"name":"Быстрый старт"}]},{"@type":"TechArticle","headline":"Быстрый старт - первый запрос к Platform API","description":"Создайте рабочее пространство и API-ключ, запросите балансы, зарегистрируйте адрес для мониторинга и настройте webhook-уведомления.","url":"https://docs.vilna.io/ru/get-started/quickstart","datePublished":"2025-09-17","dateModified":"2026-10-31","proficiencyLevel":"Beginner","dependencies":"Vilna account, browser, HTTPS webhook receiver","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-quickstart.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"быстрый-старт","__idx":0},"children":["Быстрый старт"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Зарегистрируйте свой адрес, прочитайте балансы и получите подписанный вебхук. Отправляйте запросы через ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Try it"]}," на страницах операций по ссылкам ниже. Схемы и примеры запросов находятся в справочнике."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Заранее выберите EVM-адрес под вашим контролем и подготовьте публично доступный HTTPS-обработчик. Он должен принимать POST, проверять подпись по исходному телу запроса и отвечать 2xx после надёжного сохранения доставки. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/webhooks#verify"},"children":["проверку подписи"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"key","level":2,"__idx":1},"children":["Получите ключ "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://app.vilna.io"},"children":["Зарегистрируйтесь в личном кабинете"]},", создайте рабочее пространство (workspace) и проект, затем выпустите ключ проекта. Для этого сценария нужны права ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:blockchain:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:address:write"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:balance:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:activity:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:channel:write"]}," и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api:subscription:write"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Сохраните полный ключ в хранилище секретов: последующие чтения показывают только фрагмент и метаданные. Укажите его как ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Api-Key"]}," в настройке авторизации справочника. Не передавайте этот ключ своему обработчику. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/authentication"},"children":["Аутентификацию"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Перед каждой изменяющей операцией сохраните отдельный ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," вместе с точным телом запроса и назначением операции. При потере ответа повторяйте тот же запрос с тем же ключом. Не создавайте новый ключ, пока исход предыдущей попытки неизвестен. Окна повтора и восстановление описаны в разделе ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/idempotency"},"children":["Идемпотентность"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"verify","level":2,"__idx":2},"children":["Проверьте доступ "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Откройте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/blockchain/list-blockchains"},"children":["List blockchains"]}," и отправьте запрос через Try it. Успешный ответ подтверждает доступ ключа к каталогу сетей. Сохраните CAIP-2 идентификатор поддерживаемой EVM-сети для выбранного адреса, например ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1"]}," для Ethereum. При чтении каталога учитывайте пагинацию."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"monitor","level":2,"__idx":3},"children":["Добавьте адрес для мониторинга "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Откройте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/address/create-external-address"},"children":["Create external address"]},". Выберите пример ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["from_address"]},", замените ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input.value"]}," своим EVM-адресом, оставьте ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["input.chain_family: evm"]}," и задайте понятную метку. Укажите сохранённый ключ идемпотентности и отправьте запрос."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Сохраните канонический ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}," адреса и метку из ответа для последующих запросов и сверки. Регистрация действует в рамках семейства сетей; она не переводит средства и не даёт Vilna права подписи. Поддержка других семейств отличается: для ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["solana"]}," доступны регистрация и определение токенов, но не балансы и мониторинг транзакций. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/core-concepts"},"children":["Основные понятия"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"read","level":2,"__idx":4},"children":["Прочитайте балансы и активность "]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Используйте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/balance/summarize-balances"},"children":["Summarize balances"]}," с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["family=evm"]}," для итогов проекта или ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/balance/search-balances"},"children":["Search balances"]},", передав возвращённый адрес в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addresses"]},", для одного адреса. При необходимости ограничьте поиск выбранной сетью через ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chain_gids"]},". Оба результата разбиты на страницы и относятся к одному семейству; другие поддерживаемые семейства запрашивайте отдельно."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["В ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/activity/list-activity"},"children":["List activity"]}," доступны изменения балансов. У неиспользованного адреса может не быть записей баланса или активности. Для расчётов используйте целочисленные строки ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]},", для отображения - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["formatted"]},". См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/get-started/core-concepts#amounts"},"children":["Суммы"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"id":"events","level":2,"__idx":5},"children":["Получите события "]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Откройте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/channel/create-channel"},"children":["Create channel"]},". Задайте понятное имя, выберите конфигурацию вебхука, укажите HTTPS URL обработчика и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload_version: v2"]},". Отправьте запрос с отдельным сохранённым ключом идемпотентности. Сразу сохраните ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", имя канала и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_secret"]}," из ответа. Окно повтора ответа с секретом ограничено; см. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/idempotency"},"children":["Идемпотентность"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Откройте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/channel/test-channel"},"children":["Test channel"]},", укажите сохранённый ID канала и ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["family=evm"]},". Используйте отдельный сохранённый ключ идемпотентности. Ответ ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202"]}," означает принятие теста, а не доставку. Проверьте подписанную тестовую доставку в обработчике и его ответ 2xx. Тест проверяет доставку без активности в блокчейне и не создаёт подписку."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Откройте ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/apis/platform/api/subscription/create-subscription"},"children":["Create subscription"]},". Задайте имя, сохранённый ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["channel_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["family=evm"]}," и триггер ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["block"]}," с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after_blocks: 0"]},". Для ограничения выбранной сетью задайте её ID в ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.chain_gids"]},". Установите ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_noise_filtered: true"]},". Сохраните намерение и тело запроса перед отправкой. Сохраните ID и имя подписки из ответа. Новая конфигурация возвращает ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201"]},", точное совпадение с существующей может вернуть ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Дождитесь новой подходящей транзакции с отслеживаемым адресом. Подписка сама не создаёт активность в блокчейне. Убедитесь, что обработчик проверил и сохранил настоящее событие: у него ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_test: false"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Уведомление с ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["after_blocks: 0"]}," сообщает о раннем включении в блок, а не об окончательности. Применяйте свою политику подтверждений и сверяйте состояние транзакции перед зачислением. См. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/events#triggers"},"children":["События и мониторинг"]}," и ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/channels#payment-flow"},"children":["сверку состояния"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Сохраняйте ID события для обработки дубликатов, а ID канала и подписки - для управления ими. В ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ru/guides/integration-patterns"},"children":["Паттернах интеграции"]}," описаны сценарии депозитов, казначейства и счетов."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"id":"next"},"children":[]}]}]},"headings":[{"value":"Быстрый старт","id":"быстрый-старт","depth":1},{"value":"Получите ключ","id":"key","depth":2},{"value":"Проверьте доступ","id":"verify","depth":2},{"value":"Добавьте адрес для мониторинга","id":"monitor","depth":2},{"value":"Прочитайте балансы и активность","id":"read","depth":2},{"value":"Получите события","id":"events","depth":2}],"frontmatter":{"seo":{"title":"Быстрый старт - первый запрос к Platform API","description":"Создайте рабочее пространство и API-ключ, запросите балансы, зарегистрируйте адрес для мониторинга и настройте webhook-уведомления.","priority":0.9,"image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-quickstart.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Главная","item":"https://docs.vilna.io/ru/"},{"@type":"ListItem","position":2,"name":"Начало работы","item":"https://docs.vilna.io/ru/get-started"},{"@type":"ListItem","position":3,"name":"Быстрый старт"}]},{"@type":"TechArticle","headline":"Быстрый старт - первый запрос к Platform API","description":"Создайте рабочее пространство и API-ключ, запросите балансы, зарегистрируйте адрес для мониторинга и настройте webhook-уведомления.","url":"https://docs.vilna.io/ru/get-started/quickstart","datePublished":"2025-09-17","dateModified":"2026-10-31","proficiencyLevel":"Beginner","dependencies":"Vilna account, browser, HTTPS webhook receiver","image":"https://cdn.vilna.io/docs/og/26103121/ru/get-started-quickstart.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}}},"lastModified":"2026-10-31T22:07:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ru/get-started/quickstart","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}