Skip to content
Navo24Navo24

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ÖrnekZorunlu
Ziyaretçilerin göreceği şirket adıAcme LogisticsEvet
Uygulamaların çalışacağı domain’ler (production, staging)acme.com, www.acme.com, staging.acme.comEvet
Logo, SVG veya PNG, kare işaret ya da yatayhttps://acme.com/logo.svgEvet
Marka rengi, tek hex değer#0e6ba8Evet
Ek renkler, fontlar, köşe yuvarlamabkz. 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ı istedikleritakip, navlun, sefer programlarından herhangi biri, AI modu açık veya kapalıEvet
Uygulama başına aylık veya yıllık kullanım limititakip: ayda 300 benzersiz shipmentEvet
Her uygulamanın yer alacağı sayfalar/track, /rates, /schedulesÖnerilir
“Powered by Navo” gösterilsin veya gizlensingösterilsinVarsayı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:

PaketAnahtardaki uygulamalarZiyaretçinin gördüğü
Sadece takiptrackingTakip sayfası; arama widget’ı sekmesiz ve AI anahtarı olmadan takip kutusunu gösterir
AI ile takiptracking, aiAynısı, ek olarak arama widget’ında AI modu ve shipment’larda “AI’ya sor”
Fiyatlar ve sefer programlarıfreight, schedulesArama widget’ında iki sekme, fiyatlar ve sefer programları sayfaları
Her şeytracking, 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:

UygulamaBir birimÜcretsiz tekrarlar
trackingTek bir benzersiz shipment (konteyner, booking veya B/L numarası)Dönemin geri kalanında aynı shipment
freightTek bir fiyat araması (hat ve ekipman)Aynı gün aynı arama
schedulesTek bir sefer programı araması (rota, gemi veya liman)Aynı gün aynı arama
aiAI asistanına tek bir soruYok

Ö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 ile iletişime geçin.” mesajını görür. Anahtardaki diğer uygulamalar çalışmaya devam eder. Kullanımı uygulama bazında görürüz ve müşterinin sitesinde hiçbir değişiklik gerekmeden limiti herhangi bir anda artırabiliriz.

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

AttributeNe işe yarar
data-navo-appsearch, tracking, freight veya schedules.
data-navo-keySitenin yerleştirme anahtarı.
data-navo-pagesUygulamadan müşterinin sitesindeki sayfa yoluna JSON eşlemesi.
data-navo-heightpx cinsinden sabit yükseklik. Varsayılan olarak frame içeriğine göre büyür; takip tam haritadır, 680 px.
data-navo-syncoff, ziyaretçi tıkladıkça sayfa URL’sini değiştirmeden tutar.
data-navo-themeRenkler, 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.

EventNe zamanevent.detail
navo:searchBir arama sonuç döndürdüğündeapp (tracking, freight, schedules) ve sorgu: ref ya da origin, destination, container
navo:bookingBir rezervasyon talebi gönderildiğindereference, origin, destination, container, quantity, carrier, price, currency
navo:limitBir limit aramayı durdurduğundaapp, 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.

KeyNeyi değiştirirÖrnek
accentButonlar, bağlantılar, aktif sekmeler, switch’ler, focus ring. Hover ve basılı tonları buradan hesaplanır"#e4002b"
textAna metin"#1a1a1a"
mutedİkincil metin: etiketler, ipuçları, tarihler"#6b7280"
headingBaşlıklar, taşıyıcı ve gemi adları, harita çizgileri"#002f6c"
backgroundUygulamanın sayfa arka planı. "transparent" müşterinin kendi arka planının görünmesini sağlar"#ffffff"
surfaceKartlar, input’lar, tablo şeritleri"#f5f7fa"
borderKenarlıklar ve ayırıcılar"#e5e7eb"
successPozitif durumlar: teslim edildi, zamanında, en ucuz"#15803d"
radiusKartların ve panellerin köşe yuvarlaması, px (0 ile 40)8
buttonRadiusButonların ve input’ların köşe yuvarlaması, px. 999 pill şekli verir (varsayılan)6
fontGövde fontu. Herhangi bir Google Fonts ailesi sizin için yüklenir; "system" ziyaretçinin sistem fontunu kullanır"Inter"
headingFontBaşlıklar için font, aynı kurallar geçerlidir. Verilmezse başlıklar font kullanır"Playfair Display"
fontCssKendi 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"
modeKoyu 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:

  1. 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.
  2. 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ümBağ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 fiyatyukarıdaki arama artı %26quote%3D<id>
Bir hatta sefer araması/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
Tek bir seferyukarı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

  1. 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ı).
  2. Anahtarı oluşturur ve snippet’ları göndeririz.
  3. Müşteri embed.js ve container’ları ekler, önce staging üzerinde.
  4. 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.com kontrol edilir.
  5. Müşteri production domain’ini ekler (henüz listede değilse) ve yayına alır.