Agent SDK

Stwórz token osadzenia

Wydanie krótkotrwałych tokenów embedowych dla Trading Widget trybu tokenów partnera.

Zobacz jako Markdown

SDK telefon

Stwórz tokeny embed z backendu po zweryfikowaniu sesji użytkownika partnera. Przeglądarka powinna wywołać Twój punkt końcowy, a punkt końcowy powinien wywołać 6MM przez Agent SDK.

CreateEmbedTokenResponse resp = client.createEmbedToken(
        CreateEmbedTokenRequest.of("agent-user-001", "tw_abc123")
                .withSymbol("ETHUSDT"));
System.out.println(resp.embedToken);
System.out.println(resp.expireAt);

Jednorazowe uprawnienia

embedToken jest krótkotrwały i jednorazowy. Nie umieszczaj go w ciągu zapytania URL .

Przykład endpointu backendowego

@PostMapping("/api/trading/embed-token")
public EmbedTokenView createEmbedToken(@RequestBody EmbedTokenRequest request,
                                       PartnerSession session) {
    String agentUserId = session.getAgentUserId();
    CreateEmbedTokenResponse resp = agentClient.createEmbedToken(
            CreateEmbedTokenRequest.of(agentUserId, request.getChannelId())
                    .withSymbol(request.getSymbol()));
    return new EmbedTokenView(resp.embedToken, resp.expireAt, request.getChannelId());
}

Zwracaj tylko pola potrzebne dostawcy tokena Trading Widget . Nie zwracaj apiSecret, surowych pól podpisu ani wewnętrznej konfiguracji usługi.

Obsługa awarii

StanZalecane prowadzenie
Sesja użytkownika jest brakująca lub wygasłaZwróć 401 z punktu końcowego partnera i poproś użytkownika o ponowne zalogowanie.
Użytkownik agenta nie jest związanyNajpierw przypisz użytkownika, a potem spróbuj ponownie utworzyć token.
6MM zwraca tymczasowy błądZwróć błąd do ponownego spróbowania do frontendu i loguj requestId wsparcia.
channelId nie pasuje do instancji widżetuOdrzuć żądanie i odtworzyć sesję widżetów.