Checklist trước khi lên production

Mỗi mục dưới đây tương ứng một bước kiểm tra mà Backend hoặc Viewer thực hiện. Thiếu một mục, khách thấy khung trống hoặc thẻ báo lỗi, chứ không phải trang chạy chậm hơn.

Trước khi chuyển

1. Shop của bạn đã kích hoạt. Comnoira kích hoạt sau khi bạn yêu cầu chạy chính thức. Trước đó, POST /api/v1/viewer/session trả SHOWCASE_NOT_ACTIVATED.
2. Showcase ở chế độ production. Showcase Preview hoặc demo bị từ chối với SHOWCASE_NOT_IN_PRODUCTION. Khi Comnoira duyệt shop, Preview trở thành Showcase production.
3. Đoạn mã trên trang là mã production. Mã Preview dùng preview key và không có server, và không còn là mã đúng khi shop đã chạy production. Hãy thay bằng đoạn mã lấy ở trang của Showcase trong Dashboard.
4. Domain production của bạn nằm trong danh sách domain được phép của Showcase. Thêm mọi host mà trang có thể tải từ đó, chẳng hạn www.example.com và example.com, hoặc *.example.com cho mọi subdomain. Domain của site staging là một mục riêng. Chế độ Mở chấp nhận mọi domain và chỉ để thử nghiệm.
5. License key chỉ nằm trên server của bạn, chẳng hạn trong một biến môi trường. Các đoạn mã của Dashboard đọc nó từ THREEDHUB_LICENSE_KEY. Key không nằm trong code trang, file theme, repository hay log.
6. License của bạn chưa quá ngày hết hạn. License key quá ngày hết hạn bị từ chối với LICENSE_INACTIVE.

Cần biết về lưu lượng

• Mỗi lượt xem trang có Viewer tạo một request từ server của bạn tới Comnoira và một request từ trình duyệt của khách. Hãy xin mã mới cho mỗi lượt xem, và đừng phục vụ HTML đã cache có chứa mã, vì mã chỉ dùng một lần và sống 60 giây.
• Comnoira giới hạn một địa chỉ server ở 2000 request License key trong 15 phút. Một địa chỉ của khách được đổi 30 mã trong 15 phút, nên nhiều khách sau cùng một địa chỉ văn phòng dùng chung giới hạn đó.
• Thời lượng phiên lấy từ gói license. Khi shop vượt số lượt xem hàng tháng của gói, session vẫn được cấp và Viewer hiện một thông báo ở cuối: "Bản dùng thử hoặc gói đã hết hạn, hãy gia hạn".

Kiểm tra trong trình duyệt

Mở trang production với tab network của trình duyệt. Bạn sẽ thấy, theo thứ tự:

1. Một lời gọi tới route của chính bạn, trả HTTP 200 với body chứa mã.
2. POST https://api.comnoira.com/api/v1/viewer/session/exchange, trả HTTP 200.
3. Một frame tải viewer.comnoira.com.

Nếu thiếu hoặc lỗi một trong ba, Xử lý sự cố liệt kê nguyên nhân cho từng mã.