54321G
Liftmira
View live demos
HomeArticleAboutContactDocs
View live demos

Nâng cao

Xử lý sự cố

Viewer trống hoặc hiện lỗi. Ý nghĩa của từng mã và việc cần đổi, từ console của trình duyệt đến Dashboard.

This guide hasn't been translated into English yet, showing the Vietnamese version.

Switch to the Vietnamese version of this page

Bắt đầu từ điều bạn thấy trên trang. Ba trường hợp dưới đây cho biết lỗi xảy ra ở đâu. Mỗi lỗi có một mã viết hoa, và mã đó cho biết nguyên nhân.

The viewer is empty or shows an error

Decision tree. First choose what you see on the page, then read the code to find the cause and the fix.

What do you see on the page?
  • The container is empty, no iframe

    What does the console or the VIEWER_ERROR event say?

    • SERVICE_UNAVAILABLENo answer. Check your own route, the network and the 15-second limit.
    • LICENSE_KEY_MISSING, LICENSE_KEY_INVALID, LICENSE_INACTIVE, LICENSE_KEY_SHOP_MISMATCHCheck the License key in your server, its end date and its shop.
    • SHOWCASE_NOT_FOUND, SHOWCASE_NOT_ACTIVATED, SHOWCASE_NOT_IN_PRODUCTIONCheck the Showcase ID, that your shop is active and that you use the production code.
    • EXCHANGE_TOKEN_INVALIDThe code was used already or is older than 60 seconds. Look for cached HTML or a reused code.
    • ORIGIN_NOT_ALLOWEDAdd the page's domain to the Showcase's allowed domains.
    • RATE_LIMITEDToo many requests from one address. Wait and reload.
  • The viewer opens and shows a card with a code

    Which code is printed on the card?

    • SHOWCASE_NOT_ACTIVATEDYour shop is not active yet.
    • SHOWCASE_DISABLED, SHOWCASE_NOT_FOUNDThe Showcase was switched off or removed in the Dashboard.
    • ORIGIN_NOT_ALLOWEDThe domain list changed or the page is on another host.
    • SESSION_EXPIRED, SESSION_INVALIDPress Reload. If it keeps coming back, check your route.
    • RATE_LIMITED, SERVICE_UNAVAILABLEThe service is busy. Press Retry.
    • PREVIEW_ENDED, PREVIEW_NOT_ENABLED_HERE, PREVIEW_PAGE_LIMIT, PREVIEW_DAILY_LIMIT, PREVIEW_UNAVAILABLEA Preview rule applies. See Troubleshooting.
  • The model shows, with a small notice

    Which notice?

    • Sample contentThe Showcase still holds the sample content of your industry.
    • PreviewThe page runs a Preview, not production.
    • Trial/plan expired, renew soonThe license passed its end date or the shop used its monthly views. The viewer keeps working.

Tìm mã ở đâu

Trong console của trình duyệt, SDK ghi [Comnoira SDK] init failed kèm lỗi. Trang của bạn cũng đọc được mã từ sự kiện VIEWER_ERROR, mang theo { code, message, fatal }. Khi chính Viewer hiện thẻ lỗi, mã được in nhỏ trên thẻ.

Trường hợp 1: khung chứa vẫn trống

Không có iframe nào xuất hiện, nghĩa là lỗi xảy ra trước khi Viewer khởi động. Mã trong console hoặc trong VIEWER_ERROR cho biết bước nào lỗi.

  • SERVICE_UNAVAILABLE: SDK không nhận được phản hồi. Route của bạn trả lỗi hoặc bị lỗi, khách mất mạng, hoặc một request chạy quá 15 giây. Mở tab network và xem route của bạn trước.
  • LICENSE_KEY_MISSING, LICENSE_KEY_INVALID, LICENSE_INACTIVE, LICENSE_KEY_SHOP_MISMATCH: lời gọi từ server của bạn bị từ chối. Đọc phản hồi của POST /api/v1/viewer/session trong log server. Kiểm tra biến môi trường chứa đúng License key, license chưa quá ngày hết hạn, và key thuộc đúng shop sở hữu Showcase.
  • SHOWCASE_NOT_FOUND: Showcase ID sai, hoặc Showcase không hoạt động.
  • SHOWCASE_NOT_ACTIVATED: shop của bạn chưa kích hoạt. Dùng Preview cho đến khi Comnoira kích hoạt.
  • SHOWCASE_NOT_IN_PRODUCTION: Showcase là demo hoặc Preview. Hãy dùng mã production.
  • EXCHANGE_TOKEN_INVALID: mã đã được dùng hoặc quá 60 giây. Tìm HTML trang bị cache có chứa mã, route trả cùng một mã hai lần, hoặc trang khởi động SDK hai lần với một mã.
  • ORIGIN_NOT_ALLOWED: domain của trang không có trong danh sách domain được phép của Showcase. Thêm đúng host, hoặc *.tên-miền-của-bạn, trong Dashboard.
  • RATE_LIMITED: quá nhiều request từ một địa chỉ. Chờ một lúc rồi tải lại.
  • Container #id not found trong console: tuỳ chọn container chỉ tới phần tử chưa tồn tại lúc init chạy. Viết id không có # và gọi init sau khi phần tử đã có.

Trường hợp 2: Viewer mở ra và hiện một thẻ

Phiên đã chạy được và Viewer đã hỏi Backend về Showcase. Một thẻ có tiêu đề và một mã nhỏ xuất hiện.

  • SHOWCASE_NOT_ACTIVATED: "Trưng bày này chưa sẵn sàng." Shop chưa kích hoạt.
  • SHOWCASE_DISABLED hoặc SHOWCASE_NOT_FOUND: "Trưng bày này hiện không khả dụng." Showcase đã bị tắt hoặc xoá trong Dashboard.
  • ORIGIN_NOT_ALLOWED: "Website này không được phép hiển thị Trưng bày này." Danh sách domain đã đổi, hoặc khách vào trang qua một host khác. Thẻ này cũng hiện khi SDK gia hạn phiên.
  • SESSION_EXPIRED hoặc SESSION_INVALID: "Phiên của bạn đã hết hạn." Thẻ có nút Tải lại, và SDK xin phiên mới. Nếu thẻ cứ quay lại, kiểm tra route của bạn còn chạy không.
  • RATE_LIMITED hoặc SERVICE_UNAVAILABLE: thẻ báo dịch vụ đang bận và có nút Thử lại.

Trên Preview còn có các mã sau. PREVIEW_ENDED: Preview quá ngày kết thúc hoặc đã dùng hết số phiên. PREVIEW_NOT_ENABLED_HERE: trang không nằm trên website bạn đã xác minh, hoặc việc xác minh chưa xong. PREVIEW_PAGE_LIMIT: Preview đã mở trên nhiều trang hơn mức cho phép. PREVIEW_DAILY_LIMIT: hết hạn mức của hôm nay. PREVIEW_UNAVAILABLE: Comnoira đang tắt Preview.

Trường hợp 3: mô hình hiện ra, kèm một thông báo nhỏ

  • "Sample content" ở phía trên: Showcase vẫn chứa nội dung mẫu của ngành bạn. Mô hình của bạn thay thế nó khi Comnoira thêm vào Showcase.
  • "Preview": trang đang chạy Preview, chưa phải production.
  • "Bản dùng thử hoặc gói đã hết hạn, hãy gia hạn" ở phía dưới: phiên bị đánh dấu vì license quá ngày hết hạn, hoặc shop đã dùng hết số lượt xem hàng tháng của gói. Viewer vẫn chạy. Hãy liên hệ Comnoira về gói.

Vẫn chưa được

Viết tới liftmira@comnosoft.com kèm mã lỗi, địa chỉ trang và thời điểm thử.