Vai alla navigazione

Inserimento diretto URL

Direct Entry URL: integrazione di Agent Java SDK v0.3.0, esempi, parametri e semantica della risposta.

Visualizza come Markdown

Questa guida è rivolta a Agent Java SDK v0.3.0, Java 8+ e agli appalti pubblici contrassegnati. Gli esempi vengono eseguiti nel backend di un partner dopo aver inizializzato client in Avvio rapido.

Prerequisiti di esempio

Gli snippet Java condividono queste importazioni. Inizializza client utilizzando Quick Start e ottieni platformUserId dall’associazione salvata. Gli ID utente/ordine di esempio devono essere sostituiti con i tuoi valori persistenti.

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

Inserimento diretto URL

L’immissione diretta URL è per la modalità reindirizzamento. Un utente partner fa clic su un pulsante sul sito partner, apre il frontend 6MM e accede automaticamente.

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);

Regole sul campo:

CampoDescrizione
redirectPath6MM percorso relativo frontend. Deve iniziare con /, ad esempio /en/futures/BTCUSDT?tradingMode=real
returnUrlPartner assoluto URL utilizzato quando l’utente esce dal frontend 6MM. Sono consentiti solo http e https
expireAtScadenza del biglietto d’ingresso come timestamp Unix in secondi

L’esempio apre i futuri perpetui in modalità reale. Per il trading simulato, utilizza tradingMode=demo nel frontend e passa esplicitamente environment=SIMULATED nelle corrispondenti richieste del portafoglio backend. Il frontend tradingMode e i fondi backend environment sono configurati separatamente. La creazione di una voce URL autentica l’utente; non trasferisce fondi né seleziona un ambiente di portafoglio.

Requisiti di sicurezza:

  • webUrl contiene un biglietto una tantum. Usalo immediatamente e non conservarlo a lungo termine.
  • Se la voce URL scade o è stata utilizzata, generane una nuova dal sito partner.
  • returnUrl non deve essere javascript:, un percorso relativo o un URL con informazioni utente.

Selezione del prodotto e della modalità

Utilizza il percorso frontend corrente fornito da 6MM. Ad esempio /zh-CN/up-down?tradingMode=demo, /zh-CN/high-low?tradingMode=real, /zh-CN/grid-prediction?tradingMode=real o /zh-CN/futures/BTCUSDT?tradingMode=real. Il ticket autentica l’utente; non seleziona un ambiente di finanziamento né sposta fondi.

Vedere Scambio di secondi per esempi di reindirizzamento ed incorporati.

Fonte e guide correlate