跳到导航
Agent Java SDK

跳转入口

跳转入口: Agent Java SDK v0.3.0 接入、示例、参数及响应说明。

以 Markdown 格式查看

本文对应 Agent Java SDK v0.3.0、Java 8+ 与该标签的公开契约。示例在合作方后端运行；先按快速开始初始化 client。

示例前提

Java 示例共用以下导入。按快速开始初始化 client，从已保存的绑定取得 platformUserId。示例用户和订单 ID 必须替换为实际持久化值。

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

直接跳转入口

直接跳转入口适合用户从代理商站点点击按钮后，打开 6MM 前端并自动登录。

import com.sixmm.agent.model.CreateEntryUrlRequest;
import com.sixmm.agent.model.CreateEntryUrlResponse;
CreateEntryUrlResponse resp = client.createEntryUrl(
        CreateEntryUrlRequest.of("agent-user-001")
                .withRedirectPath("/zh-CN/futures/BTCUSDT?tradingMode=real")
                .withReturnUrl("https://partner.example.com/return#markets"));
System.out.println(resp.webUrl);
System.out.println(resp.expireAt);

字段规则：

字段说明
redirectPath6MM 前端内部相对路径，必须以 / 开头，例如 /zh-CN/futures/BTCUSDT?tradingMode=real
returnUrl用户在 6MM 前端退出时回跳的代理商绝对 URL，只允许 http 或 https
expireAt入口 ticket 过期时间，Unix 秒级时间戳

本例进入永续合约实盘页面。模拟盘前端使用 tradingMode=demo，并在对应后端钱包请求中显式选择 environment=SIMULATED。前端 tradingMode 与后端资金 environment 分别配置。创建入口链接只负责用户认证，不执行资金划转，也不替商户选择钱包环境。

安全要求：

  • webUrl 内含一次性 ticket，建议立即使用，不要长期存储。
  • 入口链接过期或已使用后，用户需要重新从代理商站点发起。
  • returnUrl 不允许使用 javascript:、相对路径或带 userinfo 的 URL。

产品与模式选择

使用 6MM 提供的当前交易前端路径。例如 /zh-CN/up-down?tradingMode=demo、/zh-CN/high-low?tradingMode=real、/zh-CN/grid-prediction?tradingMode=real 或 /zh-CN/futures/BTCUSDT?tradingMode=real。票据只用于用户认证，不选择资金环境，也不执行划转。

跳转和内嵌完整示例见秒合约接入。

来源与相关指南