Skip to navigation

Виробництво та симуляція торгівлі

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

View as Markdown

Цей посібник призначений для Agent Java SDK v0.3.0 і Java 8+.

Виберіть і режим інтерфейсу, і середовище коштів

Налаштуйте середовище фінансування партнера окремо від зовнішнього режиму торгівлі. Облікові дані для прив’язки та входу є спільними; видача квитка чи токена не вибирає гаманець і не переміщує кошти.

КонфігураціявиробництвоІмітація
Прив’язка та аутентифікаціяСпільне прив’язування користувача та одноразові облікові даніТака сама ідентифікація та автентифікація
Нові перекази та баланси користувачівПропустіть environment або використовуйте PRODUCTIONЯвно використовуйте SIMULATED
Фінансування відновлення початкового замовленняВикористовуйте збережене оригінальне середовищеВикористовуйте збережене оригінальне середовище
Режим торгівлі віджетамиtradingMode=realtradingMode=demo
Frontend HTTP/WS targetВиробнича мета надається 6MMЗмодельована мета, надана 6MM
Шість безперервних запитів данихВиробничі даніНемає селектора середовища; ці методи не запитують змодельовані дані

Для wallet-transfer-status пропуск environment використовує збережене середовище вихідного замовлення, включаючи змодельоване замовлення. Явно конфліктне середовище відхиляється. Надавайте перевагу зберіганню середовища та його явній передачі під час відновлення операції.

isSimulatedUser описує обліковий запис. Він не направляє нові запити до імітованого гаманця. Пропуск environment у новому запиті на отримання коштів все одно вибирає виробництво, навіть якщо позначка облікового запису має значення true.

Підтримувані Java моделі запитів

Ці запити підтримують withEnvironment(ExecutionEnvironment.SIMULATED):

  • TransferRequest, TransferAllOutRequest, ReverseOrderRequest.
  • QueryOrderRequest, ListOrdersRequest.
  • QueryUserAssetsRequest.
  • WalletTransferRequest, WalletTransferQueryRequest.

bind, queryAccount, createEntryUrl, createEmbedToken і шість постійних моделей запитів на запити не вибирають середовище коштів.

import com.sixmm.agent.model.ExecutionEnvironment;
import com.sixmm.agent.model.QueryUserAssetsRequest;
import com.sixmm.agent.model.QueryUserAssetsResponse;
QueryUserAssetsResponse assets = client.queryUserAssets(
QueryUserAssetsRequest.of("1188041528")
.withFunding()
.withEnvironment(ExecutionEnvironment.SIMULATED));

Ініціалізуйте client за допомогою Швидкий старт і використовуйте публічний ідентифікатор користувача зі збереженої прив’язки.

Збережіть оригінальне середовище

Зберігайте тип інтерфейсу, agentOrderNo, ідентифікатор користувача та середовище, перш ніж надсилати запит на отримання коштів. Зберігайте це середовище під час запитів статусу, відновлення, узгодження та обробки webhook. Після тайм-ауту ніколи не повторюйте спроби, пропускаючи вихідне середовище або використовуючи новий номер замовлення.

Передача коштів/контрактів залишається в одному середовищі. Імітовані кошти не можуть стати виробничими фондами. Використовуйте окремий змодельований облік на стороні партнера та впізнавані префікси замовлень, наприклад SIM-.

Змодельована послідовність інтеграції

  1. Прив’яжіть користувача та збережіть загальнодоступний ідентифікатор користувача платформи.
  2. Запит балансує з явним SIMULATED і включає Фінансування, коли це необхідно.
  3. Створіть невеликий імітований переказ фінансування та збережіть його початковий бізнес-порядок.
  4. Підтвердьте остаточний результат за допомогою спеціального запиту статусу фінансування.
  5. Відкрийте або вставте цільову сторінку секунд у режимі demo.
  6. Надішліть запит на ті самі імітовані гаманці та звірте фактичну суму переказу.
  7. Щоб протестувати постійну торгівлю, перенесіть імітацію Фінансування в імітацію Контракту та скористайтеся зовнішнім інтерфейсом імітації ф’ючерсів. Шість постійних запитів партнера не можуть перевірити змодельовану історію торгів.

Контрольний лист приймання

СценарійДокази для перевірки
ІдентичністьПрив’язане відображення користувача збережено; не можна запитувати користувачів іншого партнера.
АутентифікаціяПотоки перенаправлення та вбудовування використовують нові облікові дані; підписання не створює грошових доручень.
коштиОбидві сторони узгоджують фактичну суму та остаточний статус.
Невідомий результатВідновлення використовує оригінальне замовлення без створення другого переказу.
Ізоляція середовищаЗмодельовані серверні та зовнішні цілі узгоджуються; виробничі баланси не змінюються.
ЗапитиОбробляються необхідні фільтри користувачів/категорій, мілісекундні вікна, порожні сторінки та курсори.
Обмеження ставокУсі виклики запитів спільно використовують регулювальні параметри та повторюють оригінальну невдалу сторінку.
ЗберіганняСуми та ідентифікатори залишаються рядками; записи сутностей зберігаються безпосередньо.

Перш ніж перейти до робочого режиму, змініть як цільове призначення фонових коштів, так і зовнішній режим. Відкладені замовлення продовжують відновлюватися у вихідному середовищі.

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