Agent Java SDK

Встановіть 6MM Agent Java SDK і використовуйте підписаний бекенд API для зв’язку користувачів, передач, облікових даних для входу та верифікації вебхуків.

View as Markdown

Офіційний репозиторій

Репозиторій Java SDK є джерелом істини для SDK вихідного коду, нотаток до релізів, прикладів використання та деталей реалізації:

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

Тривалість виконання

ПредметВартість
Мінімальна версія JavaJava 8+
Рекомендований інструмент для збіркиMaven 3.9+
Група Mavencom.sixmm.exchange.sdk
Артефакт Mavenagent
Задокументований позначки джерелаv0.1.1

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

Типові обов’язки бекенду

  • Перевірити сесію партнера.
  • Відвести партнера користувача на agentUserId.
  • Зв’язування колів перед першою торгівлею або трансферними потоками.
  • Зателефонуйте createEntryUrl для одноразового повного SSO.
  • Зателефонуйте createEmbedToken для режиму Trading Widget партнера-токен.
  • Перевірити вебхуки трансферу та обробити їх ідемпотентно.

Правила безпеки та експлуатації

  • Зберігати apiSecret лише у бекенд-менеджері секретів або захищеній змінній середовища.
  • Зберігати синхронізацію часу сервера, оскільки підписані запити містять часові позначки.
  • Розглядати agentOrderNo як міцний ключ ідемпотентності та зберігати його глобально унікальним.
  • Зберігати platformUserId як рядок і зберігати його зв’язок із agentUserId.
  • Запитати початкову передачу перед повторною спробою після тайм-ауту або невизначеного результату мережі.

Наступні кроки

  • Java Швидкий старт: встановити позначене джерело та ініціалізувати AgentClient.
  • Create Embed Token: видає короткочасні облікові дані для Trading Widget.
  • Секрети та підписи: розуміють автоматичне HMAC підписування та обробку секретів.
  • Webhooks and Idempotency: перевіряти зворотні виклики та запобігати дублюванням обробки.