Skip to navigation
Agent Java SDK

Agent Java SDK

Agent Java SDK: інтеграція Agent Java SDK v0.3.0, приклади, параметри та семантика відповіді.

View as Markdown

Цей посібник призначений для Agent Java SDK v0.3.0, Java 8+ і публічного контракту з тегами. Приклади виконуються в серверній частині партнера після ініціалізації client у Швидкий старт.

Базовий рівень документації: SDK v0.3.0, прийняти 54aa3c1. Додатково дотримуються Webhook правила отримання WEBHOOKS.md на fa6c7b6; це оновлення лише для документації, без нового SDK артефакту, що містить допоміжні методи попередження.

Версія та установка

ПунктЗначення
Тег стабільного джерелаv0.3.0
JavaJava 8+
МейвенMaven 3.9+
Координатиcom.sixmm.exchange.sdk:agent:0.3.0

Джерело хостів GitHub; це не робить ці координати розв’язними з Maven Central. Використовуйте локальну установку з тегами або затверджене сховище артефактів.

Що охоплює SDK.

КатегоріяСценарійSDK APIопис
Прив’язка користувачаПрив’язати користувачаbindСтворення або отримання прив’язки між користувачем-партнером і користувачем платформи 6MM
Запити активівЗапит партнерського облікового записуqueryAccountЗапит партнерської маржі або рахунку фінансування
Запити активівЗапит ресурсів користувачаqueryUserAssetsАктиви Контракту запиту; використовуйте withFunding(), щоб включити залишки фінансування
ТрансфериПереказ фіксованої сумиtransferПереказ коштів на або з 6MM
ТрансфериПеренести все назовніtransferAllOutПеренесіть весь баланс користувача, який можна зняти, назад на партнерську платформу
ТрансфериЗворотній порядокreverseСкасувати успішну передачу, якщо серверна частина підтримує потік компенсації
ТрансфериПорядок запитуqueryOrderЗапитувати одне замовлення на переказ за номером замовлення партнера
ТрансфериСписок замовленьlistOrdersПереглядайте переказні ордери для звірки
WebhookПеревірка підписуWebhookVerifier.verifyПеревірити сировинні фонди-події та ліквідаційно-попереджувальні органи; торговельний код обробляє час, право власності та постійну перевірку дедуплікації. див Webhook Події та попередження про ліквідацію.
Гаманець для фінансуванняПереказ фінансуванняwalletTransferПартнер ↔ Фінансування або Фінансування ↔ Контракт; підтвердити повернутий статус
Гаманець для фінансуванняСтатус переказу коштівqueryWalletTransferВідновіть операцію фінансування, використовуючи вихідний номер замовлення партнера
Торговий записПрямий вхід URLcreateEntryUrlСтворіть одноразовий SSO URL для режиму перенаправлення
Торговий записВставити маркерcreateEmbedTokenСтворіть короткочасний маркер для режиму Trading Widget tokenProvider
Вічні даніПоточні безстрокові замовленняlistCurrentPerpetualOrdersЗапит поточних замовлень NORMAL або CONDITIONAL
Вічні даніБезстрокова історія замовленьlistPerpetualOrderHistoryЗапит терміналу NORMAL або CONDITIONAL замовлення
Вічні даніВічні торгиlistPerpetualTradesЗапит торгівлі заповнює явний публічний список гравців
Вічні даніПоточні безстрокові посадиlistCurrentPerpetualPositionsЗапит поточних позицій
Вічні даніБезстрокова історія позиційlistPerpetualPositionHistoryЗапит закритих позицій
Вічні даніБезстрокова бухгалтерська книгаlistPerpetualLedgerЗапит окремих записів зміни балансу контракту
Довідкові ставки FiatСписок підтримуваних фіатних валютlistSupportedFiatCurrenciesСписок фіатних валют, які зараз конвертуються в USDT
Довідкові ставки FiatЗапит довідкових ставок FXqueryExchangeRatesЗапитуйте щоденні довідкові співвідношення фіат-USDT для всіх або вибраних валют
Сервісна інформаціяСервісна версіяversionІнформація про версію служби Query Agent

Конфігурація

Отримайте наступні значення з 6MM раніше інтегруючий.

Пунктприкладопис
baseUrlhttps://agent-api.6mm.comБаза агента API URL, без косої риски в кінці
agentCodeAGENT001Код партнера
apiSecretyour-api-secretAPI секрет підпису. Зберігайте його лише на сервері
defaultCurrencyUSDTВалюта за умовчанням, зазвичай USDT
webhookUrlhttps://partner.example.com/6mm/webhookЗворотний виклик продавця URL спільний для всіх чотирьох типів подій; відправлення тілом event, без окремого попередження URL.

Рекомендації по виготовленню:

  • Використовуйте HTTPS для кінцевих точок агента API і webhook.
  • Зберігайте apiSecret у секретному менеджері, центрі конфігурації або змінній середовища.
  • Тримайте час сервера синхронізованим, бажано з NTP.
  • Зберігайте всі номери замовлень партнерів і зберігайте їх глобально унікальними.
  • Ніколи не надсилайте apiSecret у браузери, програми, міні-програми чи вихідний код інтерфейсу.

Поля автоматичного підпису

Для викликів підписаного агента API SDK автоматично вводить:

ПолеДжерелоопис
agentCodeAgentClientConfig.agentCodeКод партнера
timestampПоточна позначка часу UTC Unixсекунд
nonceБезпечний генератор випадкових змінЗахист від повторів
signHMAC-SHA256Запит на підпис
currencydefaultCurrencyЗаповнюється, якщо в запитах на переказ/рахунок не вказано валюту

Правила підписання:

  1. Виключити sign.
  2. Виключити порожні значення.
  3. Сортувати ключі за ASCII порядком.
  4. Приєднатися як k=v&k2=v2.
  5. Обчисліть HMAC-SHA256 шістнадцяткове за допомогою apiSecret.

Значення масиву серіалізуються як компактний JSON перед приєднанням до корисного навантаження підпису. Наприклад, platformUserIds підписується як ["1188041528"], надаючи platformUserIds=["1188041528"] у корисному навантаженні k=v. Зберігати порядок елементів масиву, подвійні лапки та ідентифікатори рядків; не вставляйте пробіли форматування та не використовуйте Java List.toString() (наприклад, [1188041528]). SDK обробляє цю серіалізацію автоматично.

Звичайний бізнес-код не повинен розраховувати підписи або встановлювати вручну agentCode, timestamp, nonce або sign.

Джерело та відповідні посібники