> 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.

# Entrada Direta URL

Este guia é dirigido a **Agent Java SDK `v0.3.0`**, Java 8+ e ao contrato público assinalado. Os exemplos são executados num back-end de parceiro após a inicialização de `client` em [Início rápido](/pt-PT/sdk/agent-sdk/java/quick-start).

## Pré-requisitos de exemplo

Os trechos Java partilham estas importações. Inicialize `client` utilizando o Quick Start e obtenha `platformUserId` a partir da ligação guardada. Os exemplos de IDs de utilizador/encomenda devem ser substituídos pelos seus próprios valores persistentes.

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

## Entrada Direta URL

A entrada direta URL é para o modo de redireccionamento. Um utilizador parceiro clica num botão na
site do parceiro, abre o frontend 6MM e faz login automaticamente.

```java
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:

| Campo          | Descrição                                                                                                       |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| `redirectPath` | 6MM caminho relativo do frontend. Deve começar por `/`, por exemplo `/en/futures/BTCUSDT?tradingMode=real`      |
| `returnUrl`    | Parceiro absoluto URL utilizado quando o utilizador sai do frontend 6MM. Apenas `http` e `https` são permitidos |
| `expireAt`     | Tempo 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, utilize `tradingMode=demo` no frontend e passe explicitamente `environment=SIMULATED` nos pedidos de carteira de backend correspondentes. O frontend `tradingMode` e os backend backends `environment` são configurados separadamente. Criar uma entrada URL autentica o utilizador; não transfere fundos nem seleciona um ambiente de carteira.

Requisitos de segurança:

* `webUrl` contém um ticket único. Utilize-o imediatamente e não o guarde por muito tempo.
* Se a entrada URL expirar ou tiver sido utilizada, gere uma nova no site do parceiro.
* `returnUrl` não deve ser `javascript:`, um caminho relativo ou um URL com informação do utilizador.

## Seleção do produto e modo

Utilize 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 utilizador; não seleciona um ambiente de financiamento nem movimenta fundos.

Ver [Negociação de segundos](/pt-PT/sdk/agent-sdk/java/seconds-trading) para exemplos de redireccionamento e incorporados.

## Fonte e guias relacionados

* [Fonte oficial v0.3.0](https://github.com/6mm-com/agent-java-sdk/tree/54aa3c1)
* [Visão geral da consulta e paginação](/pt-PT/sdk/agent-sdk/java/perpetual-queries)
* [Carteira de financiamento](/pt-PT/sdk/agent-sdk/java/funding-wallet)
* [Guia de atualização](/pt-PT/sdk/agent-sdk/java/upgrade)