Saltar a la navegación
Agent Java SDK

Producción y comercio simulado

Producción y comercio simulado: Agent Java SDK v0.3.0 integración, ejemplos, parámetros y semántica de respuesta.

Ver como Markdown

Esta guía está dirigida a Agent Java SDK v0.3.0 y Java 8+.

Elija tanto el modo frontend como el entorno de fondos.

Configure el entorno de fondos del backend del socio por separado del modo de negociación frontend. Las credenciales de enlace y de entrada se comparten; La emisión de un billete o token no selecciona una billetera ni mueve fondos.

ConfiguraciónProducciónSimulado
Vinculación y autenticaciónEnlace de usuario compartido y credenciales de un solo usoMisma identidad y autenticación.
Nuevas transferencias y saldos de usuariosOmita environment o use PRODUCTIONUtilice explícitamente SIMULATED
Financiar la recuperación del pedido originalUtilice el entorno original guardadoUtilice el entorno original guardado
Modo de comercio de widgetstradingMode=realtradingMode=demo
Frontend HTTP/destino WSObjetivo de producción proporcionado por 6MMObjetivo simulado proporcionado por 6MM
Seis consultas de datos permanentesDatos de producciónSin selector de entorno; Estos métodos no consultan datos simulados.

Para wallet-transfer-status, omitir environment utiliza el entorno guardado del pedido original, incluido un pedido simulado. Se rechaza un entorno explícitamente conflictivo. Prefiere almacenar el entorno y pasarlo explícitamente al recuperar una operación.

isSimulatedUser describe la cuenta. No enruta nuevas solicitudes a una billetera simulada. Omitir environment en una nueva solicitud de fondos aún selecciona producción, incluso cuando el indicador de cuenta es verdadero.

Modelos de solicitud Java admitidos

Estas solicitudes admiten withEnvironment(ExecutionEnvironment.SIMULATED):

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

bind, queryAccount, createEntryUrl, createEmbedToken y los seis modelos de solicitud de consulta perpetua no seleccionan un entorno de fondos.

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

Inicialice client usando Inicio rápido y utilice la ID de usuario pública de su enlace guardado.

Preservar el entorno original.

Conserve el tipo de interfaz, agentOrderNo, la identidad del usuario y el entorno antes de enviar una solicitud de fondos. Mantenga ese entorno durante las consultas de estado, la recuperación, la conciliación y el procesamiento webhook. Después de un tiempo de espera, nunca vuelva a intentarlo omitiendo el entorno original o utilizando un nuevo número de pedido.

Las transferencias de financiación/contratos permanecen dentro de un entorno. Los fondos simulados no pueden convertirse en fondos de producción. Utilice contabilidad simulada del lado del socio independiente y prefijos de pedidos reconocibles, como SIM-.

Secuencia de integración simulada

  1. Vincule al usuario y guarde la ID de usuario de la plataforma pública.
  2. Consulta saldos con SIMULATED explícito e incluye financiación cuando sea necesario.
  3. Cree una pequeña transferencia de fondos simulada y mantenga su orden comercial original.
  4. Confirme el resultado final con la consulta de estado de financiación dedicada.
  5. Abra o incruste la página de segundos de destino en modo demo.
  6. Consulta las mismas billeteras simuladas y concilia el monto real transferido.
  7. Para probar el comercio perpetuo, transfiera los fondos simulados al contrato simulado y utilice la interfaz de futuros simulada. Las consultas perpetuas de los seis socios no pueden validar el historial comercial simulado.

Lista de verificación de aceptación

GuiónEvidencia para verificar
IdentidadSe guarda la asignación de usuarios vinculados; Los usuarios de otro socio no pueden ser consultados.
AutenticaciónLos flujos de redirección e inserción utilizan credenciales nuevas; la firma no crea órdenes de fondos.
FondosAmbas partes están de acuerdo sobre el importe real y el estado final.
Resultado desconocidoLa recuperación utiliza el pedido original sin crear una segunda transferencia.
Aislamiento del entornoLos objetivos simulados de backend y frontend coinciden; Los saldos de producción no se ven afectados.
ConsultasSe manejan los filtros de usuario/categoría requeridos, ventanas de milisegundos, páginas vacías y cursores.
Límites de tarifasTodos los llamadores de consultas comparten la limitación y vuelven a intentar la página fallida original.
AlmacenamientoLos montos y los ID siguen siendo cadenas; Los registros de entidad se guardan de forma idempotente.

Antes de pasar a producción, cambie tanto el destino de los fondos backend como el modo frontend. Los pedidos pendientes continúan recuperándose en su entorno original.

Guías fuente y relacionadas