Ir para a navegação
Agent Java SDK

Entrada Direta URL

Entrada direta URL: integração Agent Java SDK v0.3.0, exemplos, parâmetros e semântica de resposta.

Ver como Markdown

Este guia é dirigido a Agent Java SDK v0.3.0, Java 8+ e ao contrato público assinalado. Os exemplos são executados num back-end de parceiro após a inicialização de client em Início rápido.

Pré-requisitos de exemplo

Os trechos Java partilham estas importações. Inicialize client utilizando o Quick Start e obtenha platformUserId a partir da ligação guardada. Os exemplos de IDs de utilizador/encomenda devem ser substituídos pelos seus próprios valores persistentes.

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

Entrada Direta URL

A entrada direta URL é para o modo de redireccionamento. Um utilizador parceiro clica num botão na site do parceiro, abre o frontend 6MM e faz login 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);

Regras de campo:

CampoDescrição
redirectPath6MM caminho relativo do frontend. Deve começar por /, por exemplo /en/futures/BTCUSDT?tradingMode=real
returnUrlParceiro absoluto URL utilizado quando o utilizador sai do frontend 6MM. Apenas http e https são permitidos
expireAtTempo de expiração do ticket de entrada como carimbo de data/hora Unix em segundos

O exemplo abre futuros perpétuos em modo real. Para negociação simulada, utilize tradingMode=demo no frontend e passe explicitamente environment=SIMULATED nos pedidos de carteira de backend correspondentes. O frontend tradingMode e os backend backends environment são configurados separadamente. Criar uma entrada URL autentica o utilizador; não transfere fundos nem seleciona um ambiente de carteira.

Requisitos de segurança:

  • webUrl contém um ticket único. Utilize-o imediatamente e não o guarde por muito tempo.
  • Se a entrada URL expirar ou tiver sido utilizada, gere uma nova no site do parceiro.
  • returnUrl não deve ser javascript:, um caminho relativo ou um URL com informação do utilizador.

Seleção do produto e modo

Utilize a rota de frontend atual fornecida por 6MM. Por exemplo /zh-CN/up-down?tradingMode=demo, /zh-CN/high-low?tradingMode=real, /zh-CN/grid-prediction?tradingMode=real ou /zh-CN/futures/BTCUSDT?tradingMode=real. O ticket autentica o utilizador; não seleciona um ambiente de financiamento nem movimenta fundos.

Ver Negociação de segundos para exemplos de redireccionamento e incorporados.

Fonte e guias relacionados