Tạo Token Nhúng

Phát hành token nhúng ngắn hạn cho chế độ token đối tác Trading Widget .

View as Markdown

cuộc gọi SDK

Tạo token nhúng từ backend sau khi xác thực phiên người dùng đối tác. Trình duyệt nên gọi endpoint của bạn, và endpoint của bạn nên gọi 6MM qua 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);

Thông tin đăng nhập một lần

embedToken tồn tại ngắn hạn và chỉ dùng một lần. Không đặt nó vào chuỗi truy vấn URL .

Ví dụ về điểm cuối 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}

Chỉ trả về các trường mà nhà cung cấp token Trading Widget cần thiết. Không trả về apiSecret, trường ký thô hoặc cấu hình dịch vụ nội bộ.

Xử lý lỗi

Tình trạngKhuyến nghị sử dụng
Phiên người dùng bị thiếu hoặc hết hạnTrả về 401 từ điểm cuối đối tác và yêu cầu người dùng đăng nhập lại.
Người dùng agent không bị ràng buộcRàng buộc người dùng trước, sau đó thử tạo token lại.
6MM trả về lỗi tạm thờiTrả về lỗi có thể thử lại về frontend và ghi lại requestId để được hỗ trợ.
channelId không khớp với thể hiện widgetTừ chối yêu cầu và tạo lại phiên widget.