> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.6mm.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.6mm.com/_mcp/server.

# 跳转入口

本文对应 **Agent Java SDK `v0.3.0`**、Java 8+ 与该标签的公开契约。示例在合作方后端运行；先按[快速开始](/zh-CN/sdk/agent-sdk/java/quick-start)初始化 `client`。

## 示例前提

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

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

## 直接跳转入口

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

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

字段规则：

| 字段             | 说明                                                                   |
| -------------- | -------------------------------------------------------------------- |
| `redirectPath` | 6MM 前端内部相对路径，必须以 `/` 开头，例如 `/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`。票据只用于用户认证，不选择资金环境，也不执行划转。

跳转和内嵌完整示例见[秒合约接入](/zh-CN/sdk/agent-sdk/java/seconds-trading)。

## 来源与相关指南

* [官方 v0.3.0 源码](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [合约查询与分页](/zh-CN/sdk/agent-sdk/java/perpetual-queries)
* [Funding 钱包](/zh-CN/sdk/agent-sdk/java/funding-wallet)
* [升级指南](/zh-CN/sdk/agent-sdk/java/upgrade)