Kılavuzlar
Navo uygulamalarını müşteri sitesine gömme
Web sitenize konteyner takibi, navlun fiyatları, sefer programları ve AI modunu tek script etiketi ve alan adına kilitli anahtarla kendi markanızla ekleyin.
Bir müşterinin kendi web sitesine konteyner takip özelliğini, navlun fiyatları ve sefer programlarıyla birlikte yerleştirebilirsiniz. Bunlar örnek forwarder sitesinde gördüğünüz uygulamalarla aynıdır: ana sayfa için bir arama widget’ı ve her uygulama için tam sayfa. Her biri müşterinin adı, logosu ve rengiyle gösterilir. Her görünümün kendi bağlantısı vardır, böylece bir ziyaretçi bir meslektaşına tek bir konteyneri, tek bir fiyat aramasını, tek bir fiyatı, tek bir seferi, tek bir gemiyi veya tek bir limanı gönderebilir ve bağlantı müşterinin sitesinde açılır.
Müşteri tarafında API key veya sunucu gerekmez. Yerleştirme anahtarı herkese açıktır ve yalnızca bizim onun için tanımladığımız domain’lerde çalışır.
Müşterinin bize göndereceği bilgiler
| Öğe | Örnek | Zorunlu |
|---|---|---|
| Ziyaretçilerin göreceği şirket adı | Acme Logistics | Evet |
| Uygulamaların çalışacağı domain’ler (production, staging) | acme.com, www.acme.com, staging.acme.com | Evet |
| Logo, SVG veya PNG, kare işaret ya da yatay | https://acme.com/logo.svg | Evet |
| Marka rengi, tek hex değer | #0e6ba8 | Evet |
| Ek renkler, fontlar, köşe yuvarlama | bkz. Görünüm ve his | İsteğe bağlı |
| Rezervasyon taleplerini alacak e-posta | [email protected] | Navlun fiyatları için |
| Rezervasyon talepleri için webhook URL’si (CRM/TMS tarafına) | https://acme.com/hooks/navo | İsteğe bağlı |
| Hangi uygulamaları istedikleri | takip, navlun, sefer programlarından herhangi biri, AI modu açık veya kapalı | Evet |
| Uygulama başına aylık veya yıllık kullanım limiti | takip: ayda 300 benzersiz shipment | Evet |
| Her uygulamanın yer alacağı sayfalar | /track, /rates, /schedules | Önerilir |
| “Powered by Navo” gösterilsin veya gizlensin | gösterilsin | Varsayılan: gösterilsin |
Anahtarı oluşturur ve aşağıdaki snippet’ları anahtar doldurulmuş şekilde geri göndeririz.
Bir anahtar neleri kapsayabilir
Bir anahtar tek bir uygulamayı veya birkaç uygulamayı açar, AI modu ise ayrı bir anahtardır:
| Paket | Anahtardaki uygulamalar | Ziyaretçinin gördüğü |
|---|---|---|
| Sadece takip | tracking | Takip sayfası; arama widget’ı sekmesiz ve AI anahtarı olmadan takip kutusunu gösterir |
| AI ile takip | tracking, ai | Aynısı, ek olarak arama widget’ında AI modu ve shipment’larda “AI’ya sor” |
| Fiyatlar ve sefer programları | freight, schedules | Arama widget’ında iki sekme, fiyatlar ve sefer programları sayfaları |
| Her şey | tracking, freight, schedules, ai | Üç sekmenin tamamı, AI modu, tüm sayfalar |
Widget anahtardan oluşturulur: anahtarın açmadığı bir sekme, sayfa veya AI butonu hiç çizilmez ve birisi isteği zorla gönderse bile sunucumuz veriyi reddeder.
Kullanım limitleri
Bir anahtardaki her uygulamanın kendi limiti vardır, takvim ayı veya takvim yılı bazındadır (UTC). Bir birim olarak sayılanlar:
| Uygulama | Bir birim | Ücretsiz tekrarlar |
|---|---|---|
tracking | Tek bir benzersiz shipment (konteyner, booking veya B/L numarası) | Dönemin geri kalanında aynı shipment |
freight | Tek bir fiyat araması (hat ve ekipman) | Aynı gün aynı arama |
schedules | Tek bir sefer programı araması (rota, gemi veya liman) | Aynı gün aynı arama |
ai | AI asistanına tek bir soru | Yok |
Örnek: takip için ayda 300 benzersiz shipment. Müşterinin ziyaretçileri bu 300 shipment’ı ay boyunca istedikleri kadar açıp yenileyebilir; 301. shipment sonraki ayın 1’ine kadar reddedilir. Bir uygulama limitine ulaştığında ziyaretçiler “Bu hizmet şu anda bu sitede duraklatıldı. Lütfen
Kurulum
Loader’ı uygulama gösteren her sayfaya bir kez ekleyin:
<script src="https://navo24.com/embed.js" async></script>
Ardından uygulamanın görüneceği yere bir container ekleyin.
Arama widget’ı (ana sayfa hero alanı veya herhangi bir sayfa). Anahtardaki her uygulama için (takip, fiyatlar, sefer programları) bir sekmesi olan tek kutu ve anahtarda varsa AI modu. Tek uygulama varsa sekme olmaz:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
data-navo-pages ile widget ziyaretçileri müşterinin kendi sayfalarına gönderir. Bu olmadan sonuç doğrudan widget’ın frame’i içinde açılır.
Takip sayfası (/track):
<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>
Navlun fiyatları sayfası (/rates):
<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>
Sefer programları sayfası (/schedules), üç sekmeyle: rotaya göre, gemiye göre, limana göre:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
Her uygulamada aynı data-navo-pages değerini kullanın, böylece çapraz bağlantılar (örneğin bir seferde “Fiyatları göster” veya bir shipment’ta “Gemi programı”) müşterinin sitesindeki doğru sayfaya düşer.
Seçenekler
| Attribute | Ne işe yarar |
|---|---|
data-navo-app | search, tracking, freight veya schedules. |
data-navo-key | Sitenin yerleştirme anahtarı. |
data-navo-pages | Uygulamadan müşterinin sitesindeki sayfa yoluna JSON eşlemesi. |
data-navo-height | px cinsinden sabit yükseklik. Varsayılan olarak frame içeriğine göre büyür; takip tam haritadır, 680 px. |
data-navo-sync | off, ziyaretçi tıkladıkça sayfa URL’sini değiştirmeden tutar. |
data-navo-theme | Renkler, fontlar ve köşeler için JSON, bkz. Görünüm ve his. |
Content Security Policy kullanan siteler
Site script-src veya frame-src içeren bir Content-Security-Policy header’ı (veya bir <meta http-equiv> etiketi) gönderiyorsa, ikisine de navo24.com ekleyin, aksi halde tarayıcı loader’ı veya frame’i engeller ve container boş kalır:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
frame-src yerine child-src varsa, oraya ekleyin. Başka bir şey gerekmez: uygulamalar verilerini, fontlarını ve haritalarını frame içinde, kendi politikamız altında yükler. Eksik bir direktif varsa tarayıcı konsolu engellenen direktifin adını yazar.
Analytics ve CRM için event’ler
Ziyaretçi bir şey yaptığında container DOM event’leri tetikler, böylece site bunları Google Analytics, bir tag manager veya CRM sistemine gönderebilir. Event’ler bubble eder, bu yüzden document üzerindeki tek bir listener sayfadaki her uygulamayı yakalar.
| Event | Ne zaman | event.detail |
|---|---|---|
navo:search | Bir arama sonuç döndürdüğünde | app (tracking, freight, schedules) ve sorgu: ref ya da origin, destination, container |
navo:booking | Bir rezervasyon talebi gönderildiğinde | reference, origin, destination, container, quantity, carrier, price, currency |
navo:limit | Bir limit aramayı durdurduğunda | app, code (örneğin 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>
Ziyaretçinin iletişim bilgileri event’lerde yer almaz: yalnızca rezervasyon e-postasına ve webhook’a gider.
Görünüm ve his
Varsayılan olarak uygulamalar müşterinin marka rengini anahtardan alır. Siteye daha iyi uyum sağlamak için container’a data-navo-theme ekleyin: renkler, fontlar, köşe yuvarlama ve dark mode.
<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>
Her anahtar isteğe bağlıdır. Geçerli olmayan bir değer yok sayılır, geri kalanı uygulanmaya devam eder.
| Key | Neyi değiştirir | Örnek |
|---|---|---|
accent | Butonlar, bağlantılar, aktif sekmeler, switch’ler, focus ring. Hover ve basılı tonları buradan hesaplanır | "#e4002b" |
text | Ana metin | "#1a1a1a" |
muted | İkincil metin: etiketler, ipuçları, tarihler | "#6b7280" |
heading | Başlıklar, taşıyıcı ve gemi adları, harita çizgileri | "#002f6c" |
background | Uygulamanın sayfa arka planı. "transparent" müşterinin kendi arka planının görünmesini sağlar | "#ffffff" |
surface | Kartlar, input’lar, tablo şeritleri | "#f5f7fa" |
border | Kenarlıklar ve ayırıcılar | "#e5e7eb" |
success | Pozitif durumlar: teslim edildi, zamanında, en ucuz | "#15803d" |
radius | Kartların ve panellerin köşe yuvarlaması, px (0 ile 40) | 8 |
buttonRadius | Butonların ve input’ların köşe yuvarlaması, px. 999 pill şekli verir (varsayılan) | 6 |
font | Gövde fontu. Herhangi bir Google Fonts ailesi sizin için yüklenir; "system" ziyaretçinin sistem fontunu kullanır | "Inter" |
headingFont | Başlıklar için font, aynı kurallar geçerlidir. Verilmezse başlıklar font kullanır | "Playfair Display" |
fontCss | Kendi font stylesheet’iniz (@font-face kuralları içeren https:// URL), Google Fonts üzerinde olmayan fontlar için. Sonra font ve headingFont bu dosyadaki aile adlarını kullanır | "https://acme.com/fonts/brand.css" |
mode | Koyu tasarıma sahip siteler için "dark" | "dark" |
Renkler hex biçimindedir: #rgb, #rrggbb veya #rrggbbaa.
Hazır başlangıç noktaları:
<!-- 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"}'
Tüm sayfalar için tek tema. Temayı anahtar üzerinde de saklayabiliriz. Böylece her sayfadaki her container attribute olmadan temayı alır ve daha sonra müşterinin sitesinde değişiklik yapmadan temayı ayarlayabiliriz. Bir container üzerindeki data-navo-theme, anahtarın temasına karşı özellik bazında yine önceliklidir.
Tema yalnızca frame içindeki uygulamaya ulaşır: müşterinin kendi sayfasını asla değiştirmez.
React ve Next.js, arama indeksleme ile
Müşterinin sitesi React veya Next.js ile oluşturulduysa ve uygulamanın içeriği müşterinin sayfası olarak indekslenmeliyse bunu kullanın (örneğin hat başına bir sayfa, “Shanghai to Hamburg sailing schedule”).
İki parçadan oluşur:
- Snapshot. Müşterinin sunucusu hattın verisini bizden düz HTML olarak alır (sefer programı tablosu veya fiyat tablosu, bir başlık, tek satırlık özet ve schema.org markup) ve kendi sayfasına koyar. Arama motorları bunu müşterinin URL’sinde, müşterinin içeriği olarak indeksler.
- Uygulama. Tarayıcıda interaktif uygulama bunun üstüne mount edilir, arama, filtreler, detaylar ve rezervasyonla birlikte. Snapshot sayfada uygulamanın altında katlanabilir tablo olarak kalır, böylece crawler’lar ve ziyaretçiler aynı içeriği görür.
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
format=html olmadan cevap JSON olur:
{
"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"
}
}
Sayfanın <title> ve meta description alanı için title ve description, gövde için html kullanın. Cevap 30 dakika cache’lenebilir (Cache-Control: max-age=1800). Bir snapshot, uygulamanın limitine karşı bir arama sayılır; aynı gün aynı hat ücretsizdir. Takip için snapshot yoktur: shipment’lar ziyaretçiye özeldir.
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>
)}
</>
);
}
Bir arama motoruna böyle görünür: sayfanın kendi başlığı ve açıklaması, HTML içinde bir başlık ve seferlerin (veya fiyatların) tam tablosu, Dataset markup ile birlikte. Bir ziyaretçiye böyle görünür: canlı uygulama, ilgili hatta zaten açık, altında katlanmış tablo olarak aynı sonuçlarla. JavaScript kapalı olan ziyaretçiler açık tabloyu görür. Tablo katlanmıştır, gizli değildir, bu yüzden sayfa crawler’lara bir ziyaretçinin açamayacağı hiçbir şey göstermez.
Snapshot HTML sunucumuzdan her değer escape edilmiş olarak gelir, bu nedenle eklemek güvenlidir. Gösterilmesi gerekirse .navo-snapshot ve .navo-snapshot-table class’larıyla stillendirin.
Diğer sunucu framework’leri (Remix, Astro, Nuxt, PHP, WordPress) aynı şekilde çalışır: snapshot’ı sunucuda fetch edin, html içeriğini sayfaya yazdırın, container’ı yanına koyun.
Düz React (sunucu render yok)
Arama indeksleme önemli olmadığında (menü arkasındaki takip sayfası, intranet), snapshot olmadan component yeterlidir:
Loader tek sayfalı uygulamada da (React, Vue, Svelte) aynı şekilde çalışır: container’ı render edin, sonra window.NavoEmbed.mount() çağırın.
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' }} />
Next.js içinde bunu bir client component’e koyun ('use client').
Neden frame
Loader her uygulamayı navo24.com üzerinden gelen bir frame içinde çizer. Stripe Checkout, Google Maps embed’leri ve YouTube player’ları da aynı nedenlerle böyle çalışır:
- Alan kilidi. Tarayıcının kendisi, uygulamanın anahtarın listesinde olmayan bir sitede gösterilmesini reddeder (
frame-ancestors). Müşterinin sayfasına yüklenen bir script component’i bu şekilde kilitlenemez. - Stil çakışması yok. Müşterinin CSS’i uygulamayı bozamaz ve bizim CSS’imiz onların sitesine dokunamaz.
- Müşteri olmadan güncellemeler. Yeni taşıyıcılar, düzeltmeler ve özellikler aynı gün her siteye ulaşır; müşteri tarafında yükseltilecek hiçbir şey yoktur.
- Arama motorları. Frame içindeki içerik, herhangi bir harita veya video embed’inde olduğu gibi müşterinin sayfası olarak indekslenmez. Bu önemli olduğunda sunucuda render edilen snapshot’ı ekleyin, bkz. React ve Next.js, arama indeksleme ile.
Ziyaretçiler frame içinde oturum açmaz, bu nedenle tarayıcıların third-party cookie engellemesi bunu etkilemez.
Tek bir kesin görünüme bağlantılar
Ziyaretçi bir uygulamada çalışırken sayfa URL’si onu takip eder: ?navo_app=<app>&navo=<view>. Uygulamaların içindeki Bağlantıyı kopyala butonları da aynı tür bağlantı üretir. Müşteri sayfası /rates üzerindeki örnekler:
| Görünüm | Bağlantı |
|---|---|
| Bir konteyner | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| Bir hatta fiyat araması | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| Tek bir fiyat | yukarıdaki arama artı %26quote%3D<id> |
| Bir hatta sefer araması | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| Tek bir sefer | yukarıdaki arama artı %26sailing%3D<id> |
| Bir gemi | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| Bir liman | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
Paylaşılan bir fiyat veya sefer, canlı sonuçlardan çıkmış olsa bile açılmaya devam eder; verisinin alındığı tarihle birlikte gösterilir.
Rezervasyon talepleri
Bir fiyattaki Rezervasyon yap bir talep formu açar (iletişim, şirket, e-posta, telefon, konteyner sayısı, yükün hazır olacağı tarih, yük, notlar). Gönderildiğinde:
- müşterinin rezervasyon adresine bir e-posta gider, rota, ekipman, taşıyıcı, ziyaretçinin gördüğü fiyat ve ziyaretçinin iletişim bilgileriyle birlikte. Reply-To ziyaretçidir, böylece müşteri doğrudan kendi posta kutusundan yanıt verir;
- webhook ayarlanmışsa aynı talep JSON olarak oraya POST edilir:
{
"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" }
}
}
Ziyaretçi referansla birlikte bir onay görür. Hiçbir ücret alınmaz ve taşıyıcı rezervasyonu yapılmaz: müşteri yer durumunu onaylar ve yanıt verir.
Rezervasyon e-postası veya webhook olmadan form demo olarak kalır ve bunu belirtir.
Ziyaretçiler ne görür, ne görmez
- Taşıyıcı adları ve logoları, fiyatlar, transit süreleri, geçerlilik ve bir fiyatın neleri kapsadığı.
- Taşıyıcısı belirtilmeyen fiyatlar ”
Seçimi” olarak, müşterinin logosuyla gösterilir. - Fiyat kaynakları ve platformlar asla gösterilmez. Veri tarayıcıya ulaşmadan önce sunucumuzda kaldırılırlar.
Güvenlik
Alan kilidi. Uygulama sayfaları, yalnızca anahtarın domain’lerini listeleyen Content-Security-Policy: frame-ancestors ile cevap verir, böylece tarayıcı onları başka hiçbir yerde göstermeyi reddeder. Veri istekleri anahtarı ve üst sayfanın host’unu taşır, host listede değilse reddedilir. Başka bir siteye kopyalanan anahtar orada çalışmaz.
Limitler. Bir anahtardaki her uygulamanın kendi aylık veya yıllık limiti vardır (bkz. Kullanım limitleri). Bunun üzerine her anahtarda ayda 50,000 istek güvenlik tavanı, tüm site için dakikada 600 istek üst sınırı (böylece bir sitenin trafik sıçraması uygulamaları diğerleri için yavaşlatamaz; istek üzerine artırılır) ve script tabanlı kötüye kullanıma karşı ziyaretçi bazlı rate limit’ler bulunur; bunların üzerinde uygulama kısa bir “tekrar deneyin” mesajı gösterir ve navo:limit tetikler.
Mesajlar. Frame ve loader postMessage üzerinden konuşur ve her iki taraf da yalnızca diğer tarafın tam origin’ine gönderir: frame müşterinin sayfasına, loader navo24.com adresine. Arama detayları hiçbir zaman * adresine gitmez.
Rotasyon. Bir anahtar sızarsa veya bir site el değiştirirse yeni bir anahtar veririz ve eskisi anında çalışmayı durdurur.
Yayın öncesi test
Production domain’iyle birlikte staging domain’ini veya geliştirici makinesi için localhost:<port> gönderin. İkisi aynı anahtar üzerinde durabilir.
Checklist
- Müşteri adı, domain’leri, logosu, rengi, rezervasyon e-postası, satın aldığı uygulamalar (AI modu açık veya kapalı) ve her uygulama için limiti gönderir (isteğe bağlı olarak webhook, sayfa yolları).
- Anahtarı oluşturur ve snippet’ları göndeririz.
- Müşteri
embed.jsve container’ları ekler, önce staging üzerinde. - Müşteri kontrol eder: arama → takip, fiyatlar → detaylar → rezervasyon (test e-postası gelir), paylaşılan bağlantı kendi sitesinde açılır. Sıkı CSP varsa tarayıcı konsolunda engellenen
navo24.comkontrol edilir. - Müşteri production domain’ini ekler (henüz listede değilse) ve yayına alır.