Nhúng 6MM Trading Widget: Khởi động nhanh

Thêm terminal giao dịch vào trang web với container, script v1 và TradingWidget.create().

View as Markdown

Trading Widget SDK tích hợp giao diện giao dịch 6MM vào một trang web thuộc sở hữu của đối tác. Tích hợp nhanh nhất yêu cầu một container hiển thị, script SDK sản xuất, và một cuộc gọi TradingWidget.create().

Trước khi bạn bắt đầu

  • Chạy ví dụ từ một trang web có thể tải tài nguyên từ https://app.6mm.com.
  • Đặt cho container widget một chiều rộng và chiều cao rõ ràng.
  • Tải SDK trước khi gọi TradingWidget.create().
  • Lên kế hoạch luồng xác thực trước khi kích hoạt tính năng tài khoản hoặc giao dịch trong môi trường sản xuất.

Ví dụ tối thiểu

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>

Khi tích hợp thành công, SDK tạo một iframe bên trong #trading-widget và gọi onReady. Thu thập onError trong quá trình phát triển để các lỗi cấu hình và tải được hiển thị.

URL SDK

Môi trườngKịch bản URL
Sản xuấthttps://app.6mm.com/sdk/trading-widget/v1/index.js

Đặt baseUrl một cách rõ ràng

Khi kiểm thử từ các trang thuộc sở hữu của đối tác, hãy chuyển baseUrl sao cho iframe luôn trỏ đến miền Web 6MM .

Điều khiển hiển thị

Nhúng đối tác mặc định ẩn tiêu đề PC và mã thị trường đáy. Sử dụng display khi bạn cần hiển thị các khu vực shell đó hoặc ẩn các container cấp cao trong trang giao dịch nhúng.

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

Kích thước container

Bề mặtMức tối thiểu khuyến nghị
Máy tính để bàn1024 x 720
Di động390 x 700

Đối với bố cục đáp ứng, giữ cho chiều rộng linh hoạt và đặt chiều cao tối thiểu phù hợp cho mỗi điểm ngừng. Một container có chiều cao bằng 0 có thể nạp SDK thành công trong khi giao diện giao dịch không hiển thị.

Xác minh sự tích hợp

  1. Xác nhận script SDK trả về thành công trong bảng mạng trình duyệt.
  2. Xác nhận onReady kích hoạt sau khi iframe được khởi tạo.
  3. Kiểm tra các phần symbol, locale, chủ đề và các phần ẩn đã được cấu hình.
  4. Thay đổi kích thước trang trên cả các điểm dừng trên máy tính để bàn và trên thiết bị di động.
  5. Hoàn thành kiểm tra xác thực với người dùng không phải sản xuất trước khi khởi động.

Các vấn đề phổ biến

Triệu chứngNhững gì cần kiểm tra
Khu vực widget trốngXác nhận container có chiều rộng và chiều cao hiển thị.
TradingWidget là không xác địnhXác nhận script v1 đã được tải trước khi gọi create.
Sai trang hoặc môi trườngThiết lập baseUrl một cách rõ ràng và xác minh môi trường đã cấu hình.
Sự kiện sẵn sàng không bao giờ kích hoạtThu thập onError và kiểm tra các yêu cầu iframe hoặc script bị chặn.
Dữ liệu tài khoản không khả dụngHoàn thành quy trình xác thực widget được hỗ trợ.

Các bước tiếp theo