> ## 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 и интеграциям

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

Эта страница подсказывает, куда идти с вопросом разработчика или интегратора. Выберите подходящую категорию и следуйте инструкции.

<Note>
  Полный справочник по API опубликован на [openapi.intention-testnet.xyz](https://openapi.intention-testnet.xyz), сайт для разработчиков — [dev.intention.xyz](https://dev.intention.xyz/). Форматы полезной нагрузки местами ещё меняются, поэтому по любой несостыковке письмо быстрее спецификации.
</Note>

<h2 id="questions-about-api-usage">
  Вопросы по работе с API
</h2>

Если вы интегрируетесь раньше, чем вышел публичный справочник, напишите на `contact@intention.xyz` и в одной строке опишите, что вы делаете и какие эндпоинты вам понадобятся. Команда интеграций расскажет, как поверхность API выглядит сейчас, и отметит всё, что, скорее всего, изменится до запуска.

Если вы уже работаете с эндпоинтом и он ведёт себя не так, как ожидалось, напишите на `contact@intention.xyz` и приложите тело запроса, тело ответа, значимые заголовки и время вызова в UTC. Обращения, в которых приведены проблемная полезная нагрузка и фактический ответ, обычно закрываются за один круг переписки: команда интеграций может воспроизвести их прямо на staging.

<h2 id="questions-about-protocol-internals">
  Вопросы об устройстве протокола
</h2>

Если вы пытаетесь понять, почему протокол ведёт себя так, а не иначе — семантика сопоставления, гарантии упорядочивания, движение комиссий, математика маржи, сертификация оракульных цен, — начните с раздела архитектуры на этом сайте. Страница [IntentionKernel](/ru/protocol/architecture/kernel) описывает исполнение, [IntentionBFT](/ru/protocol/architecture/intention-bft) — консенсус, страница [Мост](/ru/protocol/architecture/bridge) — депозиты и выводы. Если после них остаётся вопрос архитектурного, а не операционного характера, напишите на `contact@intention.xyz`: в одном абзаце сформулируйте, что именно вы пытаетесь понять и с какой страницы начали. Команда протокола разбирает такие вопросы и либо отвечает напрямую, либо ставит задачу на доработку документации, чтобы следующему читателю спрашивать не пришлось.

<h2 id="commercial-integration">
  Коммерческая интеграция
</h2>

Партнёрства, листинги, соглашения о маркет-мейкинге и всё, что подразумевает деловые отношения, — на `contact@intention.xyz`. Укажите в одной строке, что вы делаете, кто вы и что вам нужно от Intention Labs, чтобы это заработало. Внятное первое письмо заметно сокращает переписку.

<h2 id="security-disclosures">
  Раскрытие уязвимостей
</h2>

Вопросы безопасности — всё, что вы не хотели бы показать случайному человеку в интернете до появления исправления, — отправляйте на `contact@intention.xyz`, указав в теме письма **Security**: такие письма разбираются вне очереди. Правила программы описаны на странице [Bug bounty](/ru/protocol/security/bug-bounty). Прочитайте её перед отправкой: право на вознаграждение даёт именно следование описанной процедуре.

<h2 id="summary">
  Сводка
</h2>

| Тема                               | Что приложить                                                                       |
| ---------------------------------- | ----------------------------------------------------------------------------------- |
| Эндпоинт ведёт себя неожиданно     | Тело запроса, тело ответа, заголовки и время вызова в UTC                           |
| Документ по протоколу неоднозначен | С какой страницы вы начали и что именно пытаетесь понять                            |
| Коммерческая интеграция            | Что вы делаете, кто вы и что вам нужно от Intention Labs                            |
| Раскрытие уязвимости               | Тема письма **Security** и процедура [bug bounty](/ru/protocol/security/bug-bounty) |

Всё идёт на `contact@intention.xyz`. Внятное первое письмо заметно сокращает переписку.