Sematkan 6MM Trading Widget: Mulai Cepat

Tambahkan terminal trading ke halaman web dengan kontainer, skrip v1, dan TradingWidget.create().

View as Markdown

Trading Widget SDK menyematkan antarmuka trading 6MM ke dalam halaman web milik mitra. Integrasi tercepat membutuhkan kontainer yang terlihat, skrip produksi SDK, dan panggilan ke TradingWidget.create().

Sebelum Anda mulai

  • Jalankan contoh dari halaman web yang dapat memuat sumber daya dari https://app.6mm.com.
  • Berikan wadah widget lebar dan tinggi yang jelas.
  • Muat SDK sebelum memanggil TradingWidget.create().
  • Rencanakan alur otentikasi sebelum mengaktifkan fitur akun atau trading dalam produksi.

Contoh minimal

1<div id="trading-widget" style="width: 100%; height: 720px"></div>
2
3<script src="https://app.6mm.com/sdk/trading-widget/v1/index.js"></script>
4<script>
5 const widget = TradingWidget.create('#trading-widget', {
6 baseUrl: 'https://app.6mm.com',
7 symbol: 'BTCUSDT',
8 theme: 'dark',
9 locale: 'en',
10 layout: 'default',
11 display: {
12 showHeader: false,
13 showTicker: false,
14 hidden: [],
15 },
16 onReady(event) {
17 console.log('ready', event)
18 },
19 onError(error) {
20 console.error('error', error)
21 },
22 })
23</script>

Ketika integrasi berhasil, SDK membuat iframe di dalam #trading-widget dan memanggil onReady. Tangkap onError selama pengembangan agar kegagalan konfigurasi dan pemuatan terlihat.

URL SDK

Tetapkan baseUrl secara eksplisit

Saat menguji dari halaman milik mitra, lewati baseUrl agar iframe selalu menunjuk ke domain Web 6MM .

Kontrol tampilan

Partner embed secara default menyembunyikan header PC dan ticker bottom market. Gunakan display saat Anda perlu menampilkan area shell tersebut atau menyembunyikan kontainer tingkat tinggi di halaman trading yang disematkan.

1display: {
2 showHeader: false,
3 showTicker: false,
4 hidden: ['account'],
5}

Ukuran kontainer

PermukaanMinimum yang direkomendasikan
Desktop1024 x 720
Mobile390 x 700

Untuk tata letak responsif, jaga lebar tetap cair dan atur ketinggian minimum yang sesuai untuk setiap titik jeda. Kontainer dengan tinggi nol dapat memuat SDK dengan sukses sambil membuat antarmuka perdagangan tidak terlihat.

Verifikasi integrasi

  1. Konfirmasi skrip SDK berhasil dikembalikan di panel jaringan browser.
  2. Konfirmasi onReady akan aktif setelah iframe diinisialisasi.
  3. Uji bagian symbolyang dikonfigurasi, locale, tema, dan bagian tersembunyi.
  4. Ubah ukuran halaman di antara breakpoint desktop dan mobile.
  5. Selesaikan tes terautentikasi dengan pengguna non-produksi sebelum peluncuran.

Masalah umum

GejalaApa yang harus diperiksa
Area widget kosongPastikan wadah memiliki lebar dan tinggi yang terlihat.
TradingWidget tidak terdefinisiKonfirmasi skrip v1 dimuat sebelum panggilan pembuatan.
Halaman atau lingkungan yang salahAtur baseUrl secara eksplisit dan verifikasi lingkungan yang dikonfigurasi.
Acara siap tidak pernah aktifTangkap onError dan periksa permintaan iframe atau skrip yang diblokir.
Data akun tidak tersediaSelesaikan alur otentikasi widget yang didukung.

Langkah selanjutnya