Skip to navigation
Agent Java SDK

Прямий вхід URL

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

View as Markdown

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

Приклад передумов

Фрагменти Java поділяють ці імпортовані файли. Ініціалізуйте client за допомогою швидкого запуску та отримайте platformUserId із збереженого зв’язування. Приклади ідентифікаторів користувача/замовлення потрібно замінити вашими постійними значеннями.

import com.sixmm.agent.*;
import com.sixmm.agent.model.*;
import java.util.*;

Прямий вхід URL

Прямий запис URL призначений для режиму перенаправлення. Користувач-партнер натискає кнопку на сайт партнера, відкриває інтерфейс 6MM і виконує автоматичний вхід.

import com.sixmm.agent.model.CreateEntryUrlRequest;
import com.sixmm.agent.model.CreateEntryUrlResponse;
CreateEntryUrlResponse resp = client.createEntryUrl(
        CreateEntryUrlRequest.of("agent-user-001")
                .withRedirectPath("/en/futures/BTCUSDT?tradingMode=real")
                .withReturnUrl("https://partner.example.com/return#markets"));
System.out.println(resp.webUrl);
System.out.println(resp.expireAt);

Правила поля:

Полеопис
redirectPath6MM інтерфейсний відносний шлях. Він має починатися з /, наприклад /en/futures/BTCUSDT?tradingMode=real
returnUrlАбсолютний партнер URL використовується, коли користувач виходить із зовнішнього інтерфейсу 6MM. Дозволено лише http і https
expireAtТермін дії вхідного квитка як мітка часу Unix у секундах

Приклад відкриває вічні ф’ючерси в реальному режимі. Для симуляції торгівлі використовуйте tradingMode=demo у інтерфейсі та явно передайте environment=SIMULATED у відповідних запитах гаманця. Frontend tradingMode і backend Funds environment налаштовуються окремо. Створення запису URL автентифікує користувача; він не переказує кошти та не вибирає середовище гаманця.

Вимоги безпеки:

  • webUrl містить одноразовий квиток. Використовуйте відразу і не зберігайте довго.
  • Якщо термін дії запису URL закінчився або був використаний, згенеруйте новий на сайті партнера.
  • returnUrl не має бути javascript:, відносним шляхом або URL з інформацією про користувача.

Вибір продукту та режиму

Використовуйте поточний інтерфейсний маршрут, наданий 6MM. Наприклад /zh-CN/up-down?tradingMode=demo, /zh-CN/high-low?tradingMode=real, /zh-CN/grid-prediction?tradingMode=real або /zh-CN/futures/BTCUSDT?tradingMode=real. Квиток аутентифікує користувача; він не обирає середовище фінансування та не переміщує кошти.

див Секундна торгівля для перенаправлення та вбудованих прикладів.

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