Agent SDK

Створити токен вбудови

Випустіть короткочасні токени вбудови Trading Widget режимі партнера-токена.

View as Markdown

SDK дзвінок

Створіть embed-токени зі свого бекенду після перевірки сесії партнера. Браузер має викликати вашу кінцеву точку, а ваша кінцева точка — 6MM через 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);

Одноразова акредитація

embedToken є короткочасним і одноразовим використанням. Не розміщуйте його у рядок URL запиту.

Приклад бекенд-кінцевої точки

@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());
}

Повертайте лише поля, необхідні постачальнику Trading Widget токенів. Не повертайте apiSecret, сирі поля підпису або внутрішню конфігурацію сервісу.

Обробка відмов

СтанРекомендоване поводження
Користувацька сесія відсутня або закінченаПоверніть 401 з партнерської кінцевої точки і попросіть користувача увійти ще раз.
Користувач агента не зв’язанийСпочатку зв’яжіть користувача, а потім спробуйте створити токени знову.
6MM повертає тимчасову помилкуПоверніть помилку, яку можна повторити, на фронтенд і зареєструйте requestId для підтримки.
channelId не збігається з екземпляром віджетаВідхиліть запит і створіть віджет заново.