Anleitungen
Navo-Apps auf der Kundenwebsite einbetten
Betten Sie Container-Tracking in Ihre Website ein, plus Frachtraten, Fahrpläne und KI-Modus, in Ihrer Marke mit einem Script-Tag und domaingebundenem Schlüssel.
Sie können Container-Tracking auf der Website eines Kunden einbetten, zusammen mit Frachtraten und Abfahrtsplänen. Es sind dieselben Apps, die Sie auf der Beispiel-Forwarder-Website sehen: ein Such-Widget für die Startseite sowie eine vollständige Seite für jede App. Jede App erscheint im Namen, Logo und Farbstil des Kunden. Jede Ansicht hat einen eigenen Link, sodass Besucher einem Kollegen genau einen Container, eine Ratensuche, eine Rate, eine Abfahrt, ein Schiff oder einen Hafen senden können, und der Link öffnet sich auf der Website des Kunden.
Auf Kundenseite sind weder API-Schlüssel noch Server erforderlich. Der Einbettungsschlüssel ist öffentlich und funktioniert nur auf den Domains, die wir dafür freigeben.
Was der Kunde uns sendet
| Element | Beispiel | Erforderlich |
|---|---|---|
| Unternehmensname, wie Besucher ihn sehen sollen | Acme Logistics | Ja |
| Domains, auf denen die Apps laufen werden (Produktion, Staging) | acme.com, www.acme.com, staging.acme.com | Ja |
| Logo, SVG oder PNG, quadratische Marke oder horizontal | https://acme.com/logo.svg | Ja |
| Markenfarbe, ein hex-Wert | #0e6ba8 | Ja |
| Weitere Farben, Schriften, Eckenrundung | siehe Look and feel | Optional |
| E-Mail-Adresse für Buchungsanfragen | [email protected] | Für Frachtraten |
| Webhook-URL für Buchungsanfragen (zum CRM/TMS) | https://acme.com/hooks/navo | Optional |
| Welche Apps gewünscht sind | eine beliebige Kombination aus Tracking, Fracht, Fahrplänen; AI-Modus ein oder aus | Ja |
| Nutzungslimit pro App, pro Monat oder pro Jahr | Tracking: 300 eindeutige Sendungen pro Monat | Ja |
| Seiten, auf denen die einzelnen Apps eingebunden werden | /track, /rates, /schedules | Empfohlen |
| “Bereitgestellt von Navo” angezeigt oder ausgeblendet | angezeigt | Standard: angezeigt |
Wir erstellen den Schlüssel und senden die folgenden Snippets mit eingetragenem Schlüssel zurück.
Was ein Schlüssel enthalten kann
Ein Schlüssel öffnet eine oder mehrere Apps, und der AI-Modus ist ein separater Schalter:
| Paket | Apps auf dem Schlüssel | Was Besucher erhalten |
|---|---|---|
| Nur Tracking | tracking | Tracking-Seite; das Such-Widget zeigt das Tracking-Feld ohne Tabs und ohne AI-Schalter |
| Tracking mit AI | tracking, ai | Dasselbe, plus AI-Modus im Such-Widget und “AI fragen” bei Sendungen |
| Raten und Fahrpläne | freight, schedules | Zwei Tabs im Such-Widget, die Raten- und Fahrplanseiten |
| Alles | tracking, freight, schedules, ai | Alle drei Tabs, AI-Modus, alle Seiten |
Das Widget wird aus dem Schlüssel aufgebaut: Ein Tab, eine Seite oder ein AI-Button, die der Schlüssel nicht öffnet, wird gar nicht erst gerendert, und unser Server verweigert die Daten auch dann, wenn jemand die Anfrage erzwingt.
Nutzungslimits
Jede App auf einem Schlüssel hat ihr eigenes Limit, pro Kalendermonat oder pro Kalenderjahr (UTC). Was als eine Einheit zählt:
| App | Eine Einheit | Kostenlose Wiederholungen |
|---|---|---|
tracking | Eine eindeutige Sendung (Container-, Buchungs- oder B/L-Nummer) | Dieselbe Sendung für den Rest des Zeitraums |
freight | Eine Ratensuche (Relation und Equipment) | Dieselbe Suche am selben Tag |
schedules | Eine Fahrplansuche (Route, Schiff oder Hafen) | Dieselbe Suche am selben Tag |
ai | Eine Frage an den AI-Assistenten | Keine |
Beispiel: Tracking mit 300 eindeutigen Sendungen pro Monat. Die Besucher des Kunden können diese 300 Sendungen den ganzen Monat über beliebig oft öffnen und aktualisieren; Sendung 301 wird bis zum 1st des nächsten Monats verweigert. Wenn eine App ihr Limit erreicht, sehen Besucher “Dieser Dienst ist auf dieser Website derzeit pausiert. Bitte wenden Sie sich an
Installation
Platzieren Sie den Loader einmal auf jeder Seite, die eine App anzeigt:
<script src="https://navo24.com/embed.js" async></script>
Dann einen Container an der Stelle, an der die App erscheinen soll.
Such-Widget (Hero-Bereich der Startseite oder jede andere Seite). Ein Feld mit einem Tab für jede App auf dem Schlüssel (Tracking, Raten, Fahrpläne) und AI-Modus, wenn der Schlüssel ihn enthält. Bei nur einer App gibt es keine Tabs:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
Mit data-navo-pages leitet das Widget Besucher auf die eigenen Seiten des Kunden weiter. Ohne dieses Attribut öffnet sich das Ergebnis direkt im Frame des Widgets.
Tracking-Seite (/track):
<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>
Frachtraten-Seite (/rates):
<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>
Abfahrtsplan-Seite (/schedules), mit drei Tabs: nach Route, nach Schiff, nach Hafen:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
Verwenden Sie auf jeder App denselben data-navo-pages-Wert, damit Querverweise (zum Beispiel “Raten anzeigen” auf einer Abfahrt oder “Schiffsfahrplan” auf einer Sendung) auf der richtigen Seite der Kundenwebsite landen.
Optionen
| Attribut | Funktion |
|---|---|
data-navo-app | search, tracking, freight oder schedules. |
data-navo-key | Der Einbettungsschlüssel der Website. |
data-navo-pages | JSON-Zuordnung von App zu Seitenpfad auf der Website des Kunden. |
data-navo-height | Feste Höhe in px. Standardmäßig wächst der Frame mit seinem Inhalt; Tracking ist eine vollständige Karte, 680 px. |
data-navo-sync | off lässt die Seiten-URL unverändert, während Besucher durch die App klicken. |
data-navo-theme | JSON mit Farben, Schriften und Ecken, siehe Look and feel. |
Websites mit Content Security Policy
Wenn die Website einen Content-Security-Policy-Header sendet (oder einen <meta http-equiv>-Eintrag) mit script-src oder frame-src, fügen Sie navo24.com zu beiden hinzu, andernfalls blockiert der Browser den Loader oder den Frame und der Container bleibt leer:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
Wenn child-src statt frame-src verwendet wird, fügen Sie es dort hinzu. Mehr ist nicht nötig: Die Apps laden ihre Daten, Schriften und Karten innerhalb des Frames unter unserer eigenen Policy. In der Browserkonsole wird die blockierte Direktive genannt, falls eine fehlt.
Events für Analytics und CRM
Der Container feuert DOM-Events, wenn ein Besucher etwas tut, damit die Website sie an Google Analytics, einen Tag-Manager oder ihr CRM senden kann. Sie bubblen, daher erfasst ein einzelner Listener auf document jede App auf der Seite.
| Event | Zeitpunkt | event.detail |
|---|---|---|
navo:search | Eine Suche hat Ergebnisse zurückgegeben | app (tracking, freight, schedules) und die Anfrage: ref, oder origin, destination, container |
navo:booking | Eine Buchungsanfrage wurde gesendet | reference, origin, destination, container, quantity, carrier, price, currency |
navo:limit | Ein Limit hat eine Suche gestoppt | app, code (zum Beispiel 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>
Kontaktdaten der Besucher stehen nicht in den Events: Sie gehen nur an die Buchungs-E-Mail und den Webhook.
Look and feel
Standardmäßig übernehmen die Apps die Markenfarbe des Kunden aus dem Schlüssel. Um die Website genauer zu treffen, fügen Sie data-navo-theme zum Container hinzu: Farben, Schriften, Eckenrundung und einen 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>
Jeder Schlüssel ist optional. Ein ungültiger Wert wird ignoriert, der Rest wird trotzdem angewendet.
| Schlüssel | Was geändert wird | Beispiel |
|---|---|---|
accent | Buttons, Links, aktive Tabs, Schalter, Fokus-Ring. Hover- und Pressed-Abstufungen werden daraus berechnet | "#e4002b" |
text | Haupttext | "#1a1a1a" |
muted | Sekundärtext: Labels, Hinweise, Daten | "#6b7280" |
heading | Überschriften, Carrier- und Schiffsnamen, Kartenlinien | "#002f6c" |
background | Seitenhintergrund der App. "transparent" lässt den Hintergrund des Kunden durchscheinen | "#ffffff" |
surface | Cards, Eingabefelder, Tabellenstreifen | "#f5f7fa" |
border | Rahmen und Trennlinien | "#e5e7eb" |
success | Positive Zustände: zugestellt, pünktlich, günstigste Option | "#15803d" |
radius | Eckenrundung von Cards und Panels, px (0 bis 40) | 8 |
buttonRadius | Eckenrundung von Buttons und Eingabefeldern, px. 999 ergibt Pillen (Standard) | 6 |
font | Schrift für Fließtext. Jede Google Fonts-Familie wird automatisch geladen; "system" verwendet die Systemschrift des Besuchers | "Inter" |
headingFont | Schrift für Überschriften, dieselben Regeln. Ohne diesen Wert verwenden Überschriften font | "Playfair Display" |
fontCss | Ihr eigenes Schrift-Stylesheet (https://-URL mit @font-face-Regeln), für Schriften, die nicht bei Google Fonts sind. Dann benennen font und headingFont Familien aus dieser Datei | "https://acme.com/fonts/brand.css" |
mode | "dark" für Websites mit dunklem Design | "dark" |
Farben sind hex: #rgb, #rrggbb oder #rrggbbaa.
Fertige Ausgangspunkte:
<!-- 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"}'
Ein Theme für alle Seiten. Wir können das Theme auch auf dem Schlüssel speichern. Dann erhält jeder Container auf jeder Seite das Theme ohne Attribut, und wir können es später ohne Änderung an der Website des Kunden anpassen. data-navo-theme auf einem Container gewinnt weiterhin gegenüber dem Theme des Schlüssels, Schlüssel für Schlüssel.
Das Theme erreicht nur die App im Frame: Es verändert niemals die eigene Seite des Kunden.
React und Next.js, mit Suchindexierung
Verwenden Sie dies, wenn die Website des Kunden mit React oder Next.js gebaut ist und die Inhalte der App als Seite des Kunden indexiert werden sollen (zum Beispiel eine Seite pro Relation, “Shanghai to Hamburg sailing schedule”).
Es besteht aus zwei Teilen:
- Snapshot. Der Server des Kunden ruft die Daten der Relation bei uns als reines HTML ab (Fahrplantabelle oder Ratentabelle, eine Überschrift, eine einzeilige Zusammenfassung und schema.org-Markup) und fügt sie in die eigene Seite ein. Suchmaschinen indexieren sie als Inhalt des Kunden auf der URL des Kunden.
- App. Im Browser wird die interaktive App darüber gemountet, mit Suche, Filtern, Details und Buchung. Der Snapshot bleibt als einklappbare Tabelle unter der App auf der Seite, sodass Crawler und Besucher denselben Inhalt sehen.
Snapshot-Endpunkt
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
Ohne format=html ist die Antwort 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"
}
}
Verwenden Sie title und description für das <title> der Seite und die Meta Description, html für den Body. Die Antwort kann 30 Minuten gecacht werden (Cache-Control: max-age=1800). Ein Snapshot zählt als eine Suche gegen das Limit der App; dieselbe Relation am selben Tag ist kostenlos. Für Tracking gibt es keinen Snapshot: Sendungen sind privat für den Besucher.
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>
)}
</>
);
}
So sieht es für eine Suchmaschine aus: der eigene Titel und die eigene Beschreibung der Seite, eine Überschrift und eine vollständige Tabelle mit Abfahrten (oder Raten) im HTML, mit Dataset-Markup. So sieht es für Besucher aus: die Live-App, bereits auf dieser Relation geöffnet, mit denselben Ergebnissen als eingeklappte Tabelle darunter. Besucher ohne JavaScript sehen die geöffnete Tabelle. Die Tabelle ist eingeklappt, nicht versteckt, sodass die Seite Crawlern nichts zeigt, was ein Besucher nicht öffnen kann.
Das Snapshot-HTML kommt von unserem Server, wobei jeder Wert escaped ist, daher kann es sicher eingefügt werden. Stylen Sie es bei Bedarf mit den Klassen .navo-snapshot und .navo-snapshot-table, falls es angezeigt wird.
Andere Server-Frameworks (Remix, Astro, Nuxt, PHP, WordPress) funktionieren genauso: Snapshot auf dem Server abrufen, html in die Seite ausgeben, den Container daneben platzieren.
Plain React (ohne Server-Rendering)
Wenn Suchindexierung keine Rolle spielt (eine Tracking-Seite hinter einem Menü, ein Intranet), reicht die Komponente ohne Snapshot aus:
Der Loader funktioniert in einer Single-Page-App (React, Vue, Svelte) genauso: Container rendern, dann window.NavoEmbed.mount() aufrufen.
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' }} />
In Next.js platzieren Sie sie in einer Client-Komponente ('use client').
Warum ein Frame
Der Loader rendert jede App in einem Frame von navo24.com. So funktionieren auch Stripe Checkout, Google Maps-Einbettungen und YouTube-Player, aus denselben Gründen:
- Domain-Lock. Der Browser selbst verweigert die Anzeige der App auf einer Website, die nicht in der Liste des Schlüssels steht (
frame-ancestors). Eine Script-Komponente, die in die Seite des Kunden geladen wird, kann so nicht gesperrt werden. - Keine Style-Konflikte. Das CSS des Kunden kann die App nicht beschädigen, und unser CSS kann die Website des Kunden nicht beeinflussen.
- Updates ohne den Kunden. Neue Carrier, Fixes und Funktionen erreichen jede Website am selben Tag; auf Kundenseite muss nichts aktualisiert werden.
- Suchmaschinen. Inhalte in einem Frame werden nicht als Seite des Kunden indexiert, genau wie bei jeder Karten- oder Videoeinbettung. Wenn das wichtig ist, fügen Sie den serverseitig gerenderten Snapshot hinzu, siehe React und Next.js, mit Suchindexierung.
Besucher melden sich nicht im Frame an, daher hat das Blockieren von Third-Party-Cookies durch Browser keinen Einfluss darauf.
Links zu einer exakten Ansicht
Während ein Besucher in einer App arbeitet, folgt ihm die Seiten-URL: ?navo_app=<app>&navo=<view>. Die Link kopieren-Buttons in den Apps erzeugen denselben Link-Typ. Beispiele auf einer Kundenseite /rates:
| Ansicht | Link |
|---|---|
| Ein Container | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| Ratensuche auf einer Relation | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| Eine Rate | die obige Suche plus %26quote%3D<id> |
| Abfahrtssuche auf einer Relation | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| Eine Abfahrt | die obige Suche plus %26sailing%3D<id> |
| Ein Schiff | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| Ein Hafen | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
Eine geteilte Rate oder Abfahrt lässt sich auch dann weiter öffnen, wenn sie nicht mehr in den Live-Ergebnissen steht; sie wird mit dem Datum angezeigt, an dem ihre Daten übernommen wurden.
Buchungsanfragen
Buchen auf einer Rate öffnet ein Anfrageformular (Kontakt, Unternehmen, E-Mail, Telefon, Anzahl Container, Cargo-ready date, Ladung, Notizen). Beim Absenden:
- Eine E-Mail geht an die Buchungsadresse des Kunden, mit Route, Equipment, Carrier, dem Preis, den der Besucher gesehen hat, und den Kontaktdaten des Besuchers. Reply-To ist der Besucher, sodass der Kunde direkt aus seinem Postfach antwortet;
- wenn ein Webhook eingerichtet ist, wird dieselbe Anfrage als JSON per POST dorthin gesendet:
{
"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" }
}
}
Der Besucher sieht eine Bestätigung mit der Referenz. Es wird nichts berechnet und keine Carrier-Buchung ausgelöst: Der Kunde bestätigt den Platz und antwortet.
Ohne Buchungs-E-Mail oder Webhook bleibt das Formular eine Demo und weist darauf hin.
Was Besucher sehen und was nicht
- Carrier-Namen und -Logos, Preise, Laufzeiten, Gültigkeit und was eine Rate enthält.
- Raten ohne genannten Carrier werden als ”
Select” angezeigt, mit dem Logo des Kunden. - Ratenquellen und Plattformen werden niemals angezeigt. Sie werden auf unserem Server entfernt, bevor Daten den Browser erreichen.
Sicherheit
Domain-Lock. Die App-Seiten antworten mit Content-Security-Policy: frame-ancestors, in der nur die Domains des Schlüssels aufgeführt sind, sodass ein Browser die Anzeige überall sonst verweigert. Datenanfragen enthalten den Schlüssel und den Host der übergeordneten Seite und werden verweigert, wenn der Host nicht auf der Liste steht. Ein Schlüssel, der in eine andere Website kopiert wird, funktioniert dort nicht.
Limits. Jede App auf einem Schlüssel hat ihr eigenes monatliches oder jährliches Limit (siehe Nutzungslimits). Zusätzlich hat jeder Schlüssel eine Sicherheitsgrenze von 50,000 Requests pro Monat, eine Obergrenze von 600 Requests pro Minute für die gesamte Website (damit ein Traffic-Spike einer Website die Apps für andere nicht verlangsamt; auf Anfrage erhöhbar) und Rate-Limits pro Besucher gegen Skript-Missbrauch; darüber hinaus zeigt die App eine kurze “Erneut versuchen”-Meldung und feuert navo:limit.
Nachrichten. Frame und Loader kommunizieren über postMessage, und jede Seite sendet nur an die exakte Origin der jeweils anderen Seite: der Frame an die Kundenseite, der Loader an navo24.com. Suchdetails gehen niemals an *.
Rotation. Wenn ein Schlüssel leakt oder eine Website den Besitzer wechselt, stellen wir einen neuen Schlüssel aus, und der alte funktioniert sofort nicht mehr.
Tests vor dem Launch
Senden Sie uns die Staging-Domain zusammen mit der Produktionsdomain oder localhost:<port> für einen Entwicklerrechner. Beide können auf demselben Schlüssel liegen.
Checkliste
- Der Kunde sendet Name, Domains, Logo, Farbe, Buchungs-E-Mail, die gekauften Apps (AI-Modus ein oder aus) und das Limit für jede App (sowie optional Webhook, Seitenpfade).
- Wir erstellen den Schlüssel und senden die Snippets.
- Der Kunde fügt
embed.jsund die Container hinzu, zuerst auf Staging. - Der Kunde prüft: Suche → Tracking, Raten → Details → Buchung (eine Test-E-Mail kommt an), ein geteilter Link öffnet sich auf der eigenen Website. Bei strikter CSP die Browserkonsole auf blockiertes
navo24.comprüfen. - Der Kunde fügt die Produktionsdomain hinzu (falls noch nicht auf der Liste) und geht live.