Перейти к навигации
Agent Java SDK

Agent Java SDK

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

Просмотр в формате 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+
МавенМавен 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Запрос справочных курсов валютqueryExchangeRatesЗапрос ежедневных эталонных соотношений фиатных денег к USDT для всех или выбранных валют.
Информация об обслуживанииВерсия сервисаversionИнформация о версии службы агента запросов

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

Получите следующие значения из 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.

Источник и связанные руководства