Bắt đầu
Bắt đầu tích hợp với Comnoira
Điều gì xảy ra khi bạn tạo tài khoản Comnoira, và các phần tạo nên một tích hợp hoạt động được trên website của bạn — trước cả khi có mô hình 3D thật.
Mọi tích hợp Liftira gồm ba phần: website của bạn, server của bạn, và Comnoira. Website của bạn không bao giờ gửi license key trực tiếp cho Comnoira — server của bạn đổi lấy một mã ngắn hạn trước, và chính website của bạn hoàn tất việc trao đổi đó trước khi trình xem có thể tải. Xem Trao đổi session token để biết chính xác cách hoạt động.
Trước khi viết code
- Tạo tài khoản Comnoira và một shop. Đây là nơi lưu license key và các mã nhúng của bạn.
- Tạo mã nhúng đầu tiên. Mã này hoạt động ngay lập tức — khi chưa gắn sản phẩm nào, nó sẽ load một demo nhỏ, giúp bạn tích hợp lên website trước khi có mô hình 3D thật.
- Gửi sản phẩm của bạn cho chúng tôi. Khi mã nhúng đã chạy trên trang, hãy gửi thông tin sản phẩm cho liên hệ Liftira của bạn — chúng tôi dựng mô hình 3D và xuất bản lên đúng mã nhúng đó, demo mẫu sẽ tự động được thay bằng sản phẩm thật của bạn.
Bạn không cần có mô hình 3D hoàn chỉnh để bắt đầu tích hợp. Hãy tích hợp với demo mẫu trước, sau đó để chúng tôi thay bằng sản phẩm thật của bạn sau — code tích hợp của bạn không cần thay đổi gì khi đó.
Những gì bạn cần
- Một license key Comnoira, gắn với shop của bạn
- Một backend endpoint có thể thực hiện request server-to-server (license key không bao giờ được lộ ra trình duyệt)
- Một thẻ
<script>và một<div>trên trang nơi bộ cấu hình sẽ hiển thị
Luồng hai bước
- Khách mở trang của bạn. Server của bạn yêu cầu một mã trao đổi ngắn hạn từ Comnoira bằng license key.
- Server của bạn gửi mã đó cho trình duyệt — không bao giờ gửi license key.
- Script nhúng đổi mã đó lấy session token thật trực tiếp với Comnoira, nơi kiểm tra request có thực sự đến từ domain đã đăng ký hay không, sau đó gắn bộ cấu hình 3D vào
<div>của bạn.
Khi bạn đã có token chạy thông suốt từ đầu đến cuối, hướng dẫn tiếp theo sẽ nói rõ luồng trao đổi hai bước đó diễn ra ra sao, từng request một.