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 é direcionado a Agent Java SDK v0.3.0, Java 8+ e ao contrato público marcado. Os exemplos são executados em um back-end de parceiro após a inicialização de client em Início rápido.

Pré-requisitos de exemplo

Os trechos Java compartilham essas importações. Inicialize client usando o Quick Start e obtenha platformUserId da ligação salva. Os exemplos de IDs de usuário/pedido devem ser substituídos por 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 redirecionamento. Um usuário parceiro clica em um 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 com /, por exemplo /en/futures/BTCUSDT?tradingMode=real
returnUrlParceiro absoluto URL usado quando o usuário sai do frontend 6MM. Somente 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, use tradingMode=demo no frontend e passe explicitamente environment=SIMULATED nas solicitações de carteira de backend correspondentes. Frontend tradingMode e fundos de backend environment são configurados separadamente. Criar uma entrada URL autentica o usuário; ele não transfere fundos nem seleciona um ambiente de carteira.

Requisitos de segurança:

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

Seleção de produto e modo

Use 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 usuário; não seleciona um ambiente de financiamento nem movimenta fundos.

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

Fonte e guias relacionados