Hướng dẫn
Nhúng ứng dụng Navo vào website khách hàng
Nhúng theo dõi container vào website của bạn, kèm giá cước, lịch tàu và chế độ AI theo thương hiệu riêng, chỉ với một thẻ script và khóa giới hạn theo miền.
Bạn có thể nhúng tính năng theo dõi container trên website riêng của khách hàng, kèm theo giá cước vận tải và lịch tàu. Đây chính là các ứng dụng bạn thấy trên website forwarder mẫu: một widget tìm kiếm cho trang chủ, cùng với một trang đầy đủ cho từng ứng dụng. Mỗi ứng dụng hiển thị theo tên, logo và màu thương hiệu của khách hàng. Mỗi màn hình đều có liên kết riêng, nên khách truy cập có thể gửi cho đồng nghiệp một container, một lượt tìm kiếm giá, một giá cước, một chuyến tàu, một tàu hoặc một cảng, và liên kết sẽ mở ngay trên website của khách hàng.
Không cần API key hoặc server ở phía khách hàng. Embed key là công khai và chỉ hoạt động trên các domain mà chúng tôi khai báo cho key đó.
Khách hàng cần gửi cho chúng tôi
| Mục | Ví dụ | Bắt buộc |
|---|---|---|
| Tên công ty như khách truy cập sẽ nhìn thấy | Acme Logistics | Có |
| Các domain sẽ chạy ứng dụng (production, staging) | acme.com, www.acme.com, staging.acme.com | Có |
| Logo, SVG hoặc PNG, dạng biểu tượng vuông hoặc ngang | https://acme.com/logo.svg | Có |
| Màu thương hiệu, một giá trị hex | #0e6ba8 | Có |
| Màu bổ sung, font, bo góc | xem Giao diện | Không bắt buộc |
| E-mail nhận yêu cầu đặt chỗ | [email protected] | Cho giá cước |
| Webhook URL cho yêu cầu đặt chỗ (tới CRM/TMS của họ) | https://acme.com/hooks/navo | Không bắt buộc |
| Ứng dụng họ muốn dùng | bất kỳ trong tracking, freight, schedules; bật hoặc tắt chế độ AI | Có |
| Giới hạn sử dụng theo từng ứng dụng, theo tháng hoặc theo năm | tracking: 300 lô hàng duy nhất mỗi tháng | Có |
| Các trang nơi từng ứng dụng sẽ được đặt | /track, /rates, /schedules | Khuyến nghị |
| Hiển thị hoặc ẩn “Được hỗ trợ bởi Navo” | hiển thị | Mặc định: hiển thị |
Chúng tôi tạo key và gửi lại các đoạn mã bên dưới, trong đó key đã được điền sẵn.
Một key có thể bao gồm những gì
Một key có thể mở một hoặc nhiều ứng dụng, và chế độ AI là một công tắc riêng:
| Gói | Ứng dụng trên key | Khách truy cập nhận được |
|---|---|---|
| Chỉ tracking | tracking | Trang tracking; widget tìm kiếm hiển thị ô tracking, không có tab và không có công tắc AI |
| Tracking với AI | tracking, ai | Tương tự, cộng thêm chế độ AI trong widget tìm kiếm và “Hỏi AI” trên lô hàng |
| Giá cước và lịch tàu | freight, schedules | Hai tab trong widget tìm kiếm, các trang giá cước và lịch tàu |
| Tất cả | tracking, freight, schedules, ai | Cả ba tab, chế độ AI, tất cả các trang |
Widget được dựng từ key: tab, trang hoặc nút AI nào key không mở thì hoàn toàn không được vẽ ra, và server của chúng tôi sẽ từ chối dữ liệu tương ứng ngay cả khi có người cố ép request.
Giới hạn sử dụng
Mỗi ứng dụng trên một key có giới hạn riêng, theo tháng dương lịch hoặc năm dương lịch (UTC). Một đơn vị được tính như sau:
| Ứng dụng | Một đơn vị | Lượt lặp miễn phí |
|---|---|---|
tracking | Một lô hàng duy nhất (số container, booking hoặc B/L) | Cùng lô hàng đó trong phần còn lại của kỳ |
freight | Một lượt tìm kiếm giá (tuyến và loại thiết bị) | Cùng lượt tìm kiếm trong cùng ngày |
schedules | Một lượt tìm kiếm lịch tàu (tuyến, tàu hoặc cảng) | Cùng lượt tìm kiếm trong cùng ngày |
ai | Một câu hỏi tới trợ lý AI | Không có |
Ví dụ: tracking ở mức 300 lô hàng duy nhất mỗi tháng. Khách truy cập của khách hàng có thể mở và refresh 300 lô hàng đó bao nhiêu lần tùy ý trong cả tháng; lô hàng thứ 301 sẽ bị từ chối cho đến ngày 1 của tháng tiếp theo. Khi một ứng dụng đạt giới hạn, khách truy cập sẽ thấy “Dịch vụ này hiện đang tạm dừng trên website này. Vui lòng liên hệ <tên khách hàng>.” Các ứng dụng khác trên key vẫn tiếp tục hoạt động. Chúng tôi thấy mức sử dụng theo từng ứng dụng và có thể tăng giới hạn bất cứ lúc nào, không cần thay đổi gì trên website của khách hàng.
Cài đặt
Đặt loader một lần trên mọi trang có hiển thị ứng dụng:
<script src="https://navo24.com/embed.js" async></script>
Sau đó thêm một container tại vị trí ứng dụng cần xuất hiện.
Widget tìm kiếm (hero trang chủ, hoặc bất kỳ trang nào). Một ô với một tab cho mỗi ứng dụng trên key (tracking, rates, schedules) và chế độ AI nếu key có. Nếu chỉ có một ứng dụng thì không có tab:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
Với data-navo-pages, widget sẽ đưa khách truy cập tới các trang riêng của khách hàng. Nếu không có thuộc tính này, kết quả sẽ mở ngay bên trong frame của widget.
Trang tracking (/track):
<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>
Trang giá cước vận tải (/rates):
<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>
Trang lịch tàu (/schedules), với ba tab: theo tuyến, theo tàu, theo cảng:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
Dùng cùng một giá trị data-navo-pages trên mọi ứng dụng để các liên kết chéo (ví dụ “Hiển thị giá cước” trên một chuyến tàu, hoặc “Lịch tàu” trên một lô hàng) đi đúng trang trên website của khách hàng.
Tùy chọn
| Thuộc tính | Tác dụng |
|---|---|
data-navo-app | search, tracking, freight hoặc schedules. |
data-navo-key | Embed key của website. |
data-navo-pages | Bản đồ JSON từ ứng dụng tới đường dẫn trang trên website của khách hàng. |
data-navo-height | Chiều cao cố định theo px. Mặc định frame tự tăng theo nội dung; tracking là bản đồ đầy đủ, 680 px. |
data-navo-sync | off giữ URL của trang không đổi khi khách truy cập thao tác. |
data-navo-theme | JSON chứa màu, font và bo góc, xem Giao diện. |
Website có Content Security Policy
Nếu website gửi header Content-Security-Policy (hoặc một thẻ <meta http-equiv>) với script-src hoặc frame-src, hãy thêm navo24.com vào cả hai, nếu không trình duyệt sẽ chặn loader hoặc frame và container sẽ trống:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
Nếu dùng child-src thay cho frame-src, hãy thêm vào đó. Không cần gì thêm: các ứng dụng tải dữ liệu, font và bản đồ bên trong frame, theo policy riêng của chúng tôi. Console của trình duyệt sẽ nêu tên directive bị chặn nếu thiếu directive nào đó.
Sự kiện cho analytics và CRM
Container phát DOM event khi khách truy cập thực hiện thao tác, để website có thể gửi chúng tới Google Analytics, tag manager hoặc CRM. Các event này bubble, nên chỉ cần một listener trên document là bắt được mọi ứng dụng trên trang.
| Event | Khi nào | event.detail |
|---|---|---|
navo:search | Một lượt tìm kiếm trả về kết quả | app (tracking, freight, schedules) và truy vấn: ref, hoặc origin, destination, container |
navo:booking | Một yêu cầu đặt chỗ đã được gửi | reference, origin, destination, container, quantity, carrier, price, currency |
navo:limit | Một giới hạn đã chặn lượt tìm kiếm | app, code (ví dụ site_busy, rate_limited) |
<script>
document.addEventListener('navo:search', (e) => gtag('event', 'navo_search', e.detail));
document.addEventListener('navo:booking', (e) => gtag('event', 'generate_lead', { value: e.detail.price, currency: e.detail.currency, transaction_id: e.detail.reference }));
</script>
Thông tin liên hệ của khách truy cập không nằm trong các event: chúng chỉ được gửi tới e-mail đặt chỗ và webhook.
Giao diện
Mặc định, ứng dụng lấy màu thương hiệu của khách hàng từ key. Để khớp website sát hơn, thêm data-navo-theme vào container: màu, font, bo góc và chế độ tối.
<div
data-navo-app="freight"
data-navo-key="nve_YOUR_KEY"
data-navo-theme='{"accent":"#e4002b","text":"#1a1a1a","heading":"#002f6c","font":"Inter","radius":6,"buttonRadius":6}'
></div>
Mọi key đều không bắt buộc. Giá trị không hợp lệ sẽ bị bỏ qua, các giá trị còn lại vẫn được áp dụng.
| Key | Thay đổi gì | Ví dụ |
|---|---|---|
accent | Nút, liên kết, tab đang active, công tắc, focus ring. Sắc độ hover và pressed được tính từ màu này | "#e4002b" |
text | Văn bản chính | "#1a1a1a" |
muted | Văn bản phụ: nhãn, gợi ý, ngày tháng | "#6b7280" |
heading | Heading, tên hãng vận tải và tên tàu, đường trên bản đồ | "#002f6c" |
background | Nền trang của ứng dụng. "transparent" cho phép nền riêng của khách hàng hiển thị xuyên qua | "#ffffff" |
surface | Card, input, sọc trong bảng | "#f5f7fa" |
border | Viền và đường phân cách | "#e5e7eb" |
success | Trạng thái tích cực: đã giao, đúng giờ, rẻ nhất | "#15803d" |
radius | Bo góc của card và panel, px (0 tới 40) | 8 |
buttonRadius | Bo góc của nút và input, px. 999 tạo dạng pill (mặc định) | 6 |
font | Font thân bài. Bất kỳ family nào từ Google Fonts sẽ được tải sẵn cho bạn; "system" dùng font hệ thống của khách truy cập | "Inter" |
headingFont | Font cho heading, cùng quy tắc. Nếu không có, heading dùng font | "Playfair Display" |
fontCss | Stylesheet font của bạn (https:// URL với các rule @font-face), dành cho font không có trên Google Fonts. Khi đó font và headingFont đặt tên family từ file này | "https://acme.com/fonts/brand.css" |
mode | "dark" cho các website có thiết kế tối | "dark" |
Màu là hex: #rgb, #rrggbb hoặc #rrggbbaa.
Các điểm khởi đầu có sẵn:
<!-- Corporate: square corners, navy headings -->
data-navo-theme='{"accent":"#003a70","heading":"#003a70","font":"Source Sans 3","radius":2,"buttonRadius":2}'
<!-- Soft: rounded, light grey cards -->
data-navo-theme='{"accent":"#0f766e","surface":"#f3f4f6","font":"Nunito","radius":16,"buttonRadius":999}'
<!-- Dark site -->
data-navo-theme='{"mode":"dark","accent":"#f59e0b","background":"#0b1220","surface":"#111a2e","border":"#1f2a44","text":"#e5e7eb","muted":"#94a3b8"}'
<!-- Blend into the page: the app draws no background of its own -->
data-navo-theme='{"background":"transparent","font":"system"}'
Một theme cho mọi trang. Chúng tôi cũng có thể lưu theme trên key. Khi đó mọi container trên mọi trang sẽ nhận theme đó mà không cần thuộc tính, và chúng tôi có thể điều chỉnh về sau mà không cần thay đổi gì trên website của khách hàng. data-navo-theme trên một container vẫn được ưu tiên hơn theme của key, theo từng key.
Theme chỉ đi tới ứng dụng bên trong frame: nó không bao giờ thay đổi chính trang của khách hàng.
React và Next.js, với lập chỉ mục tìm kiếm
Dùng phần này khi website của khách hàng được xây bằng React hoặc Next.js và nội dung của ứng dụng cần được lập chỉ mục như trang của khách hàng (ví dụ, một trang cho mỗi tuyến, “Shanghai to Hamburg sailing schedule”).
Gồm hai phần:
- Snapshot. Server của khách hàng lấy dữ liệu của tuyến từ chúng tôi dưới dạng HTML thuần (bảng lịch tàu hoặc bảng giá, một heading, một dòng tóm tắt và markup schema.org) rồi đưa vào trang của họ. Công cụ tìm kiếm lập chỉ mục nội dung đó như nội dung của khách hàng, trên URL của khách hàng.
- Ứng dụng. Trong trình duyệt, ứng dụng tương tác được mount phía trên, với tìm kiếm, bộ lọc, chi tiết và đặt chỗ. Snapshot vẫn nằm trên trang dưới dạng bảng có thể thu gọn bên dưới ứng dụng, để crawler và khách truy cập thấy cùng một nội dung.
Snapshot endpoint
GET https://api.navo24.com/v1/demo/embed/snapshot
?key=nve_YOUR_KEY
&app=schedules schedules | freight
&origin=CNSHA UN/LOCODE
&destination=DEHAM UN/LOCODE
&container=40HC freight only: 20GP | 40GP | 40HC
&host=acme.com the client's domain, must be on the key
&format=html optional: the HTML block only
Nếu không có format=html, phản hồi là JSON:
{
"data": {
"app": "schedules",
"title": "Sailing schedule Shanghai to Hamburg",
"description": "153 sailings from Shanghai (CNSHA) to Hamburg (DEHAM) in the next 6 weeks, 10 carriers, transit from 34 days.",
"items": [{ "carrier": "Yang Ming", "vessel": "MSC OLIVIA", "voyage": "GL642W", "etd": "2026-10-24T00:00:00", "eta": "2026-12-03T00:00:00", "transit_days": 40, "direct": true }],
"html": "<section class=\"navo-snapshot\">…</section>",
"as_of": "2026-10-22T08:52:51Z"
}
}
Dùng title và description cho <title> và meta description của trang, html cho body. Phản hồi có thể được cache trong 30 phút (Cache-Control: max-age=1800). Một snapshot được tính là một lượt tìm kiếm vào giới hạn của ứng dụng; cùng một tuyến trong cùng ngày thì miễn phí. Tracking không có snapshot: lô hàng là thông tin riêng của khách truy cập.
Next.js (App Router)
// app/schedules/[lane]/page.tsx e.g. /schedules/cnsha-deham
import NavoApp from './NavoApp';
const KEY = 'nve_YOUR_KEY';
const API = 'https://api.navo24.com/v1/demo/embed/snapshot';
async function snapshot(lane: string) {
const [origin, destination] = lane.toUpperCase().split('-');
const q = new URLSearchParams({ key: KEY, app: 'schedules', origin, destination, host: 'acme.com' });
const r = await fetch(`${API}?${q}`, { next: { revalidate: 1800 } });
return r.ok ? (await r.json()).data : null;
}
export async function generateMetadata({ params }: { params: { lane: string } }) {
const s = await snapshot(params.lane);
return s ? { title: `${s.title} | Acme Logistics`, description: s.description } : {};
}
export default async function Page({ params }: { params: { lane: string } }) {
const s = await snapshot(params.lane);
const [origin, destination] = params.lane.toUpperCase().split('-');
return (
<main>
<NavoApp
app="schedules"
embedKey={KEY}
view={{ origin, destination }}
snapshotHtml={s?.html}
theme={{ accent: '#e4002b', font: 'Inter' }}
/>
</main>
);
}
// app/schedules/[lane]/NavoApp.tsx
'use client';
import { useEffect, useRef, useState } from 'react';
const SRC = 'https://navo24.com/embed.js';
function loadNavo(): Promise<void> {
const w = window as any;
if (w.NavoEmbed) return Promise.resolve();
return new Promise((ok) => {
let s = document.querySelector<HTMLScriptElement>(`script[src="${SRC}"]`);
if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
s.addEventListener('load', () => ok(), { once: true });
});
}
type Props = {
app: 'search' | 'tracking' | 'freight' | 'schedules';
embedKey: string;
view?: Record<string, string>; // opens this lane right away
pages?: Record<string, string>;
theme?: Record<string, string | number>;
snapshotHtml?: string; // server-rendered data for search engines
};
export default function NavoApp({ app, embedKey, view, pages, theme, snapshotHtml }: Props) {
const box = useRef<HTMLDivElement>(null);
const [live, setLive] = useState(false); // until the app is up, the table is open
useEffect(() => {
if (view && !new URLSearchParams(location.search).get('navo')) {
const u = new URL(location.href);
u.searchParams.set('navo_app', app);
u.searchParams.set('navo', new URLSearchParams(view).toString());
history.replaceState(history.state, '', u);
}
loadNavo().then(() => { (window as any).NavoEmbed.mount(); setLive(true); });
}, [app, embedKey]);
return (
<>
<div
ref={box}
data-navo-app={app}
data-navo-key={embedKey}
data-navo-pages={pages ? JSON.stringify(pages) : undefined}
data-navo-theme={theme ? JSON.stringify(theme) : undefined}
/>
{snapshotHtml && (
<details open={!live}>
<summary>All results as a table</summary>
<div dangerouslySetInnerHTML={{ __html: snapshotHtml }} />
</details>
)}
</>
);
}
Cách công cụ tìm kiếm nhìn thấy trang: title và description riêng của trang, một heading và một bảng đầy đủ các chuyến tàu (hoặc giá cước) trong HTML, với markup Dataset. Cách khách truy cập nhìn thấy: ứng dụng live, đã mở sẵn đúng tuyến đó, với cùng kết quả dưới dạng một bảng được gập bên dưới. Khách truy cập tắt JavaScript sẽ thấy bảng đang mở. Bảng được gập chứ không bị ẩn, nên trang không hiển thị cho crawler bất kỳ nội dung nào mà khách truy cập không thể mở.
Snapshot HTML đến từ server của chúng tôi với mọi giá trị đã được escape, nên có thể chèn an toàn. Nếu bảng từng được hiển thị, hãy style bằng các class .navo-snapshot và .navo-snapshot-table.
Các framework server khác (Remix, Astro, Nuxt, PHP, WordPress) hoạt động theo cùng cách: fetch snapshot trên server, in html vào trang, đặt container bên cạnh.
React thuần (không server rendering)
Khi việc lập chỉ mục tìm kiếm không quan trọng (một trang tracking nằm sau menu, intranet), component không có snapshot là đủ:
Loader hoạt động tương tự trong ứng dụng single-page (React, Vue, Svelte): render container, sau đó gọi window.NavoEmbed.mount().
import { useEffect } from 'react';
const SRC = 'https://navo24.com/embed.js';
function loadNavo() {
if (window.NavoEmbed) return Promise.resolve();
return new Promise((ok) => {
let s = document.querySelector(`script[src="${SRC}"]`);
if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
s.addEventListener('load', ok, { once: true });
});
}
export function NavoApp({ app, embedKey, pages }) {
useEffect(() => { loadNavo().then(() => window.NavoEmbed.mount()); }, [app, embedKey]);
return (
<div
data-navo-app={app}
data-navo-key={embedKey}
data-navo-pages={pages ? JSON.stringify(pages) : undefined}
/>
);
}
// <NavoApp app="tracking" embedKey="nve_YOUR_KEY" pages={{ tracking: '/track' }} />
Trong Next.js, đặt nó trong client component ('use client').
Vì sao dùng frame
Loader vẽ từng ứng dụng bên trong một frame từ navo24.com. Đây là cách Stripe Checkout, Google Maps embed và YouTube player hoạt động, vì cùng những lý do:
- Khóa domain. Chính trình duyệt từ chối hiển thị ứng dụng trên website không nằm trong danh sách của key (
frame-ancestors). Một script component được tải vào trang của khách hàng không thể bị khóa theo cách này. - Không xung đột style. CSS của khách hàng không thể làm hỏng ứng dụng và CSS của chúng tôi không thể chạm vào website của họ.
- Cập nhật không cần khách hàng thao tác. Hãng vận tải mới, bản sửa lỗi và tính năng mới đến mọi website trong cùng ngày; phía khách hàng không cần nâng cấp gì.
- Công cụ tìm kiếm. Nội dung bên trong frame không được lập chỉ mục như trang của khách hàng, giống như mọi map hoặc video embed khác. Khi điều đó quan trọng, hãy thêm snapshot server-rendered, xem React và Next.js, với lập chỉ mục tìm kiếm.
Khách truy cập không đăng nhập bên trong frame, nên việc trình duyệt chặn cookie bên thứ ba không ảnh hưởng đến nó.
Liên kết tới đúng một màn hình
Khi khách truy cập làm việc trong ứng dụng, URL của trang đi theo họ: ?navo_app=<app>&navo=<view>. Các nút Sao chép liên kết bên trong ứng dụng tạo ra cùng kiểu liên kết. Ví dụ trên trang khách hàng /rates:
| Màn hình | Liên kết |
|---|---|
| Một container | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| Tìm kiếm giá trên một tuyến | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| Một giá cước | lượt tìm kiếm ở trên cộng thêm %26quote%3D<id> |
| Tìm kiếm lịch tàu trên một tuyến | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| Một chuyến tàu | lượt tìm kiếm ở trên cộng thêm %26sailing%3D<id> |
| Một tàu | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| Một cảng | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
Một giá cước hoặc chuyến tàu được chia sẻ vẫn mở được sau khi đã rời khỏi kết quả live; nó được hiển thị cùng ngày dữ liệu được lấy.
Yêu cầu đặt chỗ
Đặt chỗ trên một giá cước mở form yêu cầu (liên hệ, công ty, e-mail, điện thoại, số lượng container, ngày hàng sẵn sàng, hàng hóa, ghi chú). Khi submit:
- một e-mail được gửi tới địa chỉ đặt chỗ của khách hàng, kèm tuyến, thiết bị, hãng vận tải, mức giá khách truy cập đã thấy và thông tin liên hệ của khách truy cập. Reply-To là khách truy cập, nên khách hàng có thể trả lời trực tiếp từ mailbox của họ;
- nếu webhook được thiết lập, cùng yêu cầu đó được POST tới webhook dưới dạng JSON:
{
"type": "booking.requested",
"data": {
"reference": "BR-261020-4F2A1",
"received_at": "2026-10-20T14:05:11Z",
"site": "acme.com",
"contact": { "name": "…", "company": "…", "email": "…", "phone": "…" },
"shipment": { "origin": "Shanghai (CNSHA)", "destination": "Hamburg (DEHAM)", "container": "40ft HC", "quantity": "2", "ready_date": "2026-11-03", "cargo": "…", "notes": "…" },
"rate": { "id": "…", "carrier": "…", "price": 2140, "currency": "USD", "transit_days": 34, "departure": "2026-11-06", "valid_until": "2026-11-15" }
}
}
Khách truy cập thấy xác nhận kèm mã tham chiếu. Không có khoản phí nào được thu và không có booking nào được tạo với hãng vận tải: khách hàng xác nhận chỗ và phản hồi.
Nếu không có e-mail đặt chỗ hoặc webhook, form vẫn ở chế độ demo và sẽ nói rõ như vậy.
Khách truy cập thấy gì, và không thấy gì
- Tên và logo hãng vận tải, giá, thời gian vận chuyển, hiệu lực và những gì giá cước bao gồm.
- Giá cước không có tên hãng vận tải được hiển thị là “<Tên khách hàng> Select”, với logo của khách hàng.
- Nguồn giá cước và nền tảng không bao giờ được hiển thị. Chúng được loại bỏ trên server của chúng tôi trước khi dữ liệu tới trình duyệt.
Bảo mật
Khóa domain. Các trang ứng dụng trả về Content-Security-Policy: frame-ancestors chỉ liệt kê các domain của key, nên trình duyệt từ chối hiển thị chúng ở bất kỳ nơi nào khác. Các request dữ liệu mang theo key và host của trang cha, và bị từ chối khi host không nằm trong danh sách. Một key bị sao chép sang website khác sẽ không hoạt động ở đó.
Giới hạn. Mỗi ứng dụng trên một key có giới hạn theo tháng hoặc theo năm riêng (xem Giới hạn sử dụng). Ngoài ra, mọi key đều có mức trần an toàn 50,000 request mỗi tháng, mức trần 600 request mỗi phút cho toàn bộ website (để một đợt tăng traffic của một website không làm chậm ứng dụng cho các website khác; có thể tăng theo yêu cầu) và giới hạn tốc độ theo từng khách truy cập để chống lạm dụng bằng script; vượt các mức này, ứng dụng hiển thị thông báo ngắn “thử lại” và phát navo:limit.
Thông điệp. Frame và loader giao tiếp qua postMessage, và mỗi bên chỉ gửi tới đúng origin của bên kia: frame gửi tới trang của khách hàng, loader gửi tới navo24.com. Chi tiết tìm kiếm không bao giờ được gửi tới *.
Luân chuyển. Nếu key bị lộ hoặc website đổi chủ, chúng tôi cấp key mới và key cũ ngừng hoạt động ngay lập tức.
Kiểm thử trước khi ra mắt
Gửi cho chúng tôi domain staging cùng với domain production, hoặc localhost:<port> cho máy của lập trình viên. Cả hai có thể nằm trên cùng một key.
Checklist
- Khách hàng gửi tên, domain, logo, màu, e-mail đặt chỗ, các ứng dụng họ đã mua (bật hoặc tắt chế độ AI) và giới hạn cho từng ứng dụng (và tùy chọn webhook, đường dẫn trang).
- Chúng tôi tạo key và gửi các đoạn mã.
- Khách hàng thêm
embed.jsvà các container, trước tiên trên staging. - Khách hàng kiểm tra: tìm kiếm → tracking, rates → chi tiết → đặt chỗ (một e-mail test được gửi đến), một liên kết chia sẻ mở trên website của họ. Với CSP nghiêm ngặt, kiểm tra console của trình duyệt để xem
navo24.comcó bị chặn không. - Khách hàng thêm domain production (nếu chưa có trong danh sách) và go live.