Trading Widget Otentikasi

Mode yang disarankan: token mitra

partner-token menghindari penempatan token pendek di URL dan menyimpan apiSecret di backend partner.

const widget = TradingWidget.create('#trading-widget', {
  baseUrl: 'https://app.6mm.com',
  auth: {
    mode: 'partner-token',
    tokenProvider: async ({ channelId, symbol, reason }) => {
      const resp = await fetch('/api/trading/embed-token', {
        method: 'POST',
        credentials: 'include',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ channelId, symbol, reason }),
      })
      if (!resp.ok) {
        throw new Error('Failed to request embed token')
      }
      return resp.json()
    },
  },
})

Dokumentasi terkait

Buat Token Sematan: contoh penerbitan token backend.
Trading Widget Mulai Cepat: menyelesaikan aliran inisialisasi.
Rahasia & Penandatanganan: menyimpan kredensial Agen yang memiliki hak istimewa di backend.
Pemecahan masalah: mendiagnosis kegagalan sesi, token, asal, dan inisialisasi.

Aliran ujung belakang

1. Partner frontend receives auth_request from the iframe.
2. SDK calls tokenProvider.
3. Partner frontend calls its own backend.
4. Partner backend validates the partner session.
5. Partner backend calls 6MM Agent API or Java SDK createEmbedToken.
6. SDK sends embedToken to the iframe through postMessage.
7. iframe exchanges embedToken for a 6MM access token.
8. iframe continues initialization and emits ready.

tokenProvider kontrak

Bidang	Arah	Keterangan
channelId	SDK -> Backend mitra	Pengidentifikasi sesi widget unik. Backend harus meneruskannya ke createEmbedToken.
simbol	SDK -> Backend mitra	Simbol perdagangan saat ini atau awal diteruskan sebagai konteks integrasi; ini bukan pembatasan izin pasangan dagang token.
alasan	SDK -> Backend mitra	Mengapa SDK meminta token, seperti pemuatan awal atau penyegaran.
embedToken	Backend mitra -> SDK	Token berumur pendek yang dibuat oleh Agent SDK atau Agen API.
expireAt	Backend mitra -> SDK	Stempel waktu kedaluwarsa token dikembalikan oleh 6MM.

Penanganan kegagalan

Kondisi	Penanganan yang disarankan
Sesi mitra berakhir	Kembalikan 401 dari titik akhir mitra dan minta pengguna untuk masuk lagi.
Pembuatan token gagal untuk sementara	Lemparkan kesalahan di tokenProvider dan izinkan widget menampilkan kesalahan autentikasi.
channelId ketidakcocokan	Tolak permintaan dan buat ulang instance widget.
Pengguna tidak diizinkan untuk berdagang	Kembalikan kesalahan yang dikontrol mitra dan jangan membuat token semat.

Mode kompatibilitas: agen-sso

agent-sso mempertahankan aliran tiket lama /agent-entry. Lebih memilih token mitra untuk integrasi baru.

const widget = TradingWidget.create('#trading-widget', {
  baseUrl: 'https://app.6mm.com',
  auth: {
    mode: 'agent-sso',
    entryUrlProvider: async ({ redirectPath }) => {
      const resp = await fetch('/api/trading-entry', {
        method: 'POST',
        credentials: 'include',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ redirectPath }),
      })
      const data = await resp.json()
      return data.webUrl
    },
  },
})

Perdagangan detik dan aturan lingkungan

Untuk halaman detik, gunakan autentikasi partner-token yang sama dengan page dan tradingMode yang dikonfigurasi pada Widget. Tidak ada token prediksi terpisah. Setiap panggilan tokenProvider harus mendapatkan token satu kali baru dari backend Anda.

Kembalikan embedToken, expireAt dalam hitungan detik Unix, dan channelId asli sebagai objek tingkat atas. Respons token Agent SDK tidak mengandung channelId; backend Anda menggemakan saluran Widget saat ini. Jika titik akhir Anda membungkus respons dalam data, buka bungkusnya sebelum kembali dari tokenProvider.

Integrasi detik penuh · Panduan lingkungan dana