Buat Token Sematan

Mengeluarkan token senam yang berumur pendek untuk mode token mitra Trading Widget .
View as Markdown

SDK

Buat token embed dari backend Anda setelah memvalidasi sesi pengguna mitra. Browser harus memanggil endpoint Anda, dan endpoint Anda harus memanggil 6MM melalui Agent SDK.

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

Kredensial sekali pakai

embedToken bersifat singkat dan hanya digunakan sekali saja. Jangan menempatkannya dalam string kueri URL .

Contoh endpoint backend

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

Kembalikan hanya bidang yang dibutuhkan oleh penyedia token Trading Widget . Jangan kembalikan apiSecret, field penandatanganan mentah, atau konfigurasi layanan internal.

Penanganan kegagalan

KondisiPenanganan yang direkomendasikan
Sesi pengguna hilang atau kedaluwarsaKembalikan 401 dari endpoint mitra dan minta pengguna untuk masuk lagi.
Pengguna agen tidak terikatIkat pengguna terlebih dahulu, lalu coba ulang pembuatan token.
6MM mengembalikan kesalahan sementaraKembalikan error yang dapat dicoba ulang ke frontend dan catat requestId untuk dukungan.
channelId tidak cocok dengan instance widgetTolak permintaan dan buat ulang sesi widget.