> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# Agent Java SDK

<h2 id="official-repository">
  Официальное хранилище
</h2>

Репозиторий Java SDK является источником достоверности SDK исходного кода, примечаний к релизам, примеров использования и деталей реализации:

\[6mm-com/agent-java-sdk] ([https://github.com/6mm-com/agent-java-sdk](https://github.com/6mm-com/agent-java-sdk))

<h2 id="runtime">
  Продолжительность работы
</h2>

| Предмет                         | Ценность                 |
| ------------------------------- | ------------------------ |
| Минимальная версия Java         | Java 8+                  |
| Рекомендуемый инструмент сборки | Maven 3.9+               |
| Группа Maven                    | `com.sixmm.exchange.sdk` |
| Артефакт Maven                  | `agent`                  |
| Задокументированный источник    | `v0.1.1`                 |

Публичный репозиторий GitHub — это хостинг исходного кода, а не репозиторий зависимостей Maven. Создайте и установите отмеченный исходный код локально или опубликуйте одобренный артефакт в приватном репозитории Maven вашей организации перед использованием в командных сборках.

<h2 id="typical-backend-responsibilities">
  Типичные обязанности бэкенда
</h2>

* Проверить сессию партнёра.
* Сопоставить партнёра пользователя с agentUserId.
* Связывание коллов перед первыми торговыми или трансферными потоками.
* Вызовите createEntryUrl для одноразового полноценного SSO.
* Вызовите createEmbedToken для Trading Widget режима партнёра-токен.
* Проверять вебхуки передачи и обрабатывать их идемпотентно.

<h2 id="security-and-operational-rules">
  Правила безопасности и эксплуатации
</h2>

* Хранить `apiSecret` только в серверном менеджере секретов или защищённой переменной среды.
* Синхронизировать серверное время, поскольку подписанные запросы содержат временные метки.
* Рассматривать `agentOrderNo` как надёжный ключ идемпотентности и сохранять его глобально уникальным.
* Хранить `platformUserId` в виде строки и сохранять его связь с `agentUserId`.
* Запросить исходную передачу перед повторной попыткой после тайм-аута или неопределённого результата сети.

<h2 id="next-steps">
  Следующие шаги
</h2>

* [Java Быстрый старт](/ru/sdk/agent-sdk/java/quick-start): установите тегированный исходный код и инициализуйте `AgentClient`.
* [Create Embed Token](/ru/sdk/agent-sdk/java/embed-token): выдача кратковременных учетных данных для Trading Widget.
* [Секреты и жесты](/ru/sdk/security/secrets-signing): понимают автоматическое HMAC подписания и обработку секретов.
* [Вебхуки и идемпотентность](/ru/sdk/security/webhooks-idempotency): проверка обратных вызовов и предотвращение дублирования обработки.