> 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 Швидкий старт](/uk/sdk/agent-sdk/java/quick-start): встановити позначене джерело та ініціалізувати `AgentClient`.
* [Create Embed Token](/uk/sdk/agent-sdk/java/embed-token): видає короткочасні облікові дані для Trading Widget.
* [Секрети та підписи](/uk/sdk/security/secrets-signing): розуміють автоматичне HMAC підписування та обробку секретів.
* [Webhooks and Idempotency](/uk/sdk/security/webhooks-idempotency): перевіряти зворотні виклики та запобігати дублюванням обробки.