> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intention.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Разработчикам

> Где найти справочник API, руководства по интеграции, SDK, инструменты тестнета и исходный код для разработки на Intention.

Всё, что нужно для разработки на Intention, находится в одном из перечисленных ниже мест. Эта страница — карта.

Если вы интегрируетесь впервые, начните с **руководства по интеграции**: оно ведёт от установки SDK до исполненного ордера в тестнете. Если вы уже представляете, как система устроена, и нужны детали на уровне полей, идите сразу в **справочник API**.

<h2 id="start-here">
  Начните отсюда
</h2>

<CardGroup cols={2}>
  <Card title="Руководство по интеграции" icon="book-open" href="https://dev.intention.xyz/">
    Полный разбор для разработчика: установка, аутентификация и подпись, быстрый старт по REST, счета, рыночные данные, ордера, торговый поток, переводы USDC и ограничения частоты запросов.
  </Card>

  <Card title="Справочник API" icon="plug" href="https://testnet-openapi.intention.xyz/">
    Полная спецификация REST и WebSocket со схемами и запуском запросов прямо в браузере.
  </Card>
</CardGroup>

<h2 id="what-the-api-covers">
  Что покрывает API
</h2>

Справочник разбит на следующие группы. Количество эндпоинтов приведено по текущей спецификации тестнета.

| Группа           | Что покрывает                                                                                            |
| ---------------- | -------------------------------------------------------------------------------------------------------- |
| **Markets**      | Список бессрочных рынков, стаканы, сделки, свечи, ставки финансирования                                  |
| **Trading**      | Активные ордера, исполнения, поиск по клиентскому идентификатору ордера                                  |
| **Transactions** | Отправка, пакетная отправка, симуляция, кодирование и ожидание транзакций; оценка gas                    |
| **Accounts**     | Состояние адреса и субадреса, позиции, история ордеров, история сделок, переводы, платежи финансирования |
| **DEX Config**   | Определения бессрочных и спотовых рынков, конфигурация комиссий, ступени плеча, привязки агентов         |
| **Oracle**       | Сертифицированные цены для текущего блока                                                                |
| **Dashboard**    | Стоимость счёта, ряды P\&L, торговый календарь, сводки                                                   |
| **Export**       | Экспорт в CSV истории ордеров, истории сделок и платежей финансирования                                  |
| **WebSocket**    | Каналы подписки на стакан, сделки, тикер, свечи, субсчета, блоки и транзакции                            |

<h2 id="testnet-tools">
  Инструменты тестнета
</h2>

Интерактивные инструменты для разработки — все они размещены на сайте для разработчиков.

<CardGroup cols={2}>
  <Card title="Кран" icon="faucet" href="https://dev.intention.xyz/tools-faucet">
    Получите средства тестнета на новый счёт.
  </Card>

  <Card title="Поиск ордера" icon="magnifying-glass" href="https://dev.intention.xyz/tools-order-lookup">
    Посмотрите статус и историю любого ордера по идентификатору.
  </Card>

  <Card title="Тестер WebSocket" icon="signal-stream" href="https://dev.intention.xyz/tools-websocket">
    Подпишитесь на живые каналы и посмотрите сырые сообщения.
  </Card>

  <Card title="Верификатор BCS" icon="binary" href="https://dev.intention.xyz/tools-bcs-verifier">
    Прежде чем подписывать, проверьте, что сериализованная транзакция кодирует именно то, что вы ожидаете.
  </Card>
</CardGroup>

<h2 id="sdks-and-source">
  SDK и исходный код
</h2>

<CardGroup cols={2}>
  <Card title="SDK" icon="cubes" href="https://dev.intention.xyz/installation">
    Официальные SDK на TypeScript, Go, Python и C++ — создание счёта, подпись, сборка ордеров и переводы.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/intentionxyz">
    Исходный код SDK, ПО узла и эталонные интеграции.
  </Card>
</CardGroup>

<Note>
  Опубликованная спецификация сейчас описывает тестнет. Формы эндпоинтов достаточно стабильны, чтобы на них опираться, но всё, что ещё не обкатано на мейннете, может измениться — пока в примечаниях к релизу мейннета не сказано иначе.
</Note>

<h2 id="run-a-node">
  Запуск узла
</h2>

Запуск узла **закрыт**. Набор валидаторов держат Intention Labs и приглашённые партнёры, вход — по одобрению, а не по регистрации: публичной процедуры подключения нет, и бинарник для общего скачивания не публикуется.

Если вам нужно эксплуатировать инфраструктуру, напишите на `contact@intention.xyz`, указав в теме письма **Node operator**. О существующих ролях и о том, что приложить к письму, — на странице [Запуск узла](/ru/developers/run-a-node).

<Note>
  Чаще всего узел хотят ради доступа на чтение — надёжные запросы, история, независимость от чужого индексатора. Всё это закрывает описанный выше API вместе с [индексатором](/ru/protocol/architecture/indexer) — и ничего эксплуатировать для этого не нужно.
</Note>

<h2 id="getting-help">
  Как получить помощь
</h2>

Вопросы по интеграции, неожиданное поведение эндпоинтов и коммерческие договорённости — на `contact@intention.xyz`; что приложить к письму, описано в разделе [Вопросы разработчиков и интеграторов](/ru/help/builder-questions).