Ir para a navegação
Agent Java SDK

Produção e Negociação Simulada

Produção e Negociação Simulada: 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 e Java 8+.

Escolha o modo frontend e o ambiente de fundos

Configure o ambiente de fundos do back-end do parceiro separadamente do modo de negociação de front-end. As credenciais de ligação e de entrada são partilhadas; emitir um bilhete ou token não seleciona uma carteira nem movimenta fundos.

ConfiguraçãoProduçãoSimulado
Vinculação e autenticaçãoVinculação de utilizador partilhada e credenciais únicasMesma identidade e autenticação
Novas transferências e saldos de utilizadoresOmita environment ou utilize PRODUCTIONUsar explicitamente SIMULATED
Financiamento da recuperação do pedido originalUtilize o ambiente original guardadoUtilize o ambiente original guardado
Modo de negociação de widgetstradingMode=realtradingMode=demo
Front-end HTTP/alvo WSMeta de produção fornecida por 6MMAlvo simulado fornecido por 6MM
Seis consultas de dados perpétuosDados de produçãoSem seletor de ambiente; estes métodos não consultam dados simulados

Para wallet-transfer-status, omitir environment utiliza o ambiente guardado do pedido original, incluindo um pedido simulado. Um ambiente explicitamente conflituoso é rejeitado. Prefira armazenar o ambiente e transmiti-lo explicitamente ao recuperar uma operação.

isSimulatedUser descreve a conta. Não encaminha novos pedidos para uma carteira simulada. A omissão de environment num novo pedido de fundos ainda seleciona a produção, mesmo quando o indicador da conta é verdadeiro.

Modelos de pedido Java compatíveis

Estes pedidos suportam withEnvironment(ExecutionEnvironment.SIMULATED):

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

bind, queryAccount, createEntryUrl, createEmbedToken e os seis modelos de pedido de consulta perpétua não selecionam um ambiente de fundos.

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

Inicializar client utilizando Início rápido e utilize o ID de utilizador público da ligação guardada.

Preservar o ambiente original

Persista o tipo de interface, agentOrderNo, a identidade do utilizador e o ambiente antes de enviar um pedido de fundos. Mantenha este ambiente durante as consultas de estado, recuperação, reconciliação e processamento webhook. Após um tempo limite, nunca mais tente omitindo o ambiente original ou utilizando um novo número de encomenda.

As transferências de financiamento/contrato permanecem dentro de um ambiente. Os fundos simulados não podem tornar-se fundos de produção. Utilize contabilização simulada separada do lado do parceiro e prefixos de encomenda reconhecíveis, como SIM-.

Sequência de integração simulada

  1. Ligue o utilizador e guarde o ID do utilizador da plataforma pública.
  2. Consulte os saldos com SIMULATED explícito e inclua o financiamento quando necessário.
  3. Crie uma pequena transferência de financiamento simulada e mantenha a sua ordem comercial original.
  4. Confirme o resultado final com a consulta dedicada ao estado do financiamento.
  5. Abra ou incorpore a página de segundos alvo no modo demo.
  6. Consulte as mesmas carteiras simuladas e reconcilie o valor real transferido.
  7. Para testar a negociação perpétua, transfira o financiamento simulado para o contrato simulado e utilize o frontend de futuros simulados. As consultas permanentes dos seis parceiros não podem validar o histórico de negociação simulado.

Lista de verificação de aceitação

CenárioEvidências a verificar
IdentidadeO mapeamento do utilizador vinculado é guardado; os utilizadores de outro parceiro não podem ser consultados.
AutenticaçãoOs fluxos de redireccionamento e incorporação utilizam credenciais novas; a assinatura não cria ordens de fundos.
FundosAmbos os lados concordam com o valor real e o estatuto final.
Resultado desconhecidoA recuperação utiliza o pedido original sem criar uma segunda transferência.
Isolamento ambientalOs alvos simulados de backend e frontend concordam; os saldos de produção não são afetados.
ConsultasOs filtros de utilizador/categoria necessários, janelas de milissegundos, páginas vazias e cursores são tratados.
Limites de taxaTodos os chamadores de consulta partilham a limitação e tentam novamente a página original com falha.
ArmazenamentoOs valores e IDs permanecem strings; os registos da entidade são guardados de forma idempotente.

Antes de mudar para produção, altere a meta de fundos de back-end e o modo de front-end. Os pedidos pendentes continuam a recuperar no seu ambiente original.

Fonte e guias relacionados