Skip to content
Navo24Navo24

가이드

고객 사이트에 Navo 앱 넣기

웹사이트에 컨테이너 추적, 운임, 선박 스케줄, AI 모드를 한 줄의 스크립트 태그와 도메인 잠금 키로 귀사 브랜드에 삽입하세요.

클라이언트 자체 웹사이트에 컨테이너 추적을 운임 및 선박 스케줄과 함께 임베드할 수 있습니다. 예시 포워더 사이트에서 볼 수 있는 것과 같은 앱입니다. 홈페이지용 검색 위젯과 각 앱의 전체 페이지가 제공됩니다. 각 앱은 클라이언트의 이름, 로고, 색상으로 표시됩니다. 모든 화면에는 고유 링크가 있어 방문자가 컨테이너 하나, 운임 검색 하나, 운임 하나, 항해 하나, 선박 하나 또는 항구 하나를 동료에게 보낼 수 있으며, 링크는 클라이언트 사이트에서 열립니다.

클라이언트 측에는 API 키나 서버가 필요하지 않습니다. 임베드 키는 공개 키이며, 해당 키에 대해 등록한 도메인에서만 동작합니다.

클라이언트가 보내야 하는 정보

ItemExampleRequired
방문자에게 표시할 회사명Acme LogisticsYes
앱이 실행될 도메인, 운영 및 스테이징acme.com, www.acme.com, staging.acme.comYes
로고, SVG 또는 PNG, 정사각형 마크 또는 가로형https://acme.com/logo.svgYes
브랜드 색상, hex 값 하나#0e6ba8Yes
추가 색상, 폰트, 모서리 둥글기Look and feel 참고Optional
예약 요청을 받을 이메일[email protected]For freight rates
예약 요청용 Webhook URL, 클라이언트 CRM/TMS 연동https://acme.com/hooks/navoOptional
사용할 앱tracking, freight, schedules 중 선택, AI mode 켜기 또는 끄기Yes
앱별 월간 또는 연간 사용 한도tracking: 월 300 unique shipmentsYes
각 앱이 표시될 페이지/track, /rates, /schedulesRecommended
“Navo 제공” 표시 또는 숨김shownDefault: shown

저희가 키를 생성한 뒤, 아래 스니펫에 키를 채워 보내드립니다.

하나의 키에 담을 수 있는 것

키 하나로 앱 하나 또는 여러 앱을 열 수 있으며, AI mode는 별도 스위치입니다.

PackageApps on the keyWhat the visitor gets
Tracking onlytracking추적 페이지, 검색 위젯에는 탭과 AI 스위치 없이 추적 박스만 표시
Tracking with AItracking, ai위와 동일하며, 검색 위젯의 AI mode와 화물의 “AI에게 묻기” 추가
Rates and schedulesfreight, schedules검색 위젯의 탭 2개, 운임 및 스케줄 페이지
Everythingtracking, freight, schedules, ai탭 3개 모두, AI mode, 모든 페이지

위젯은 키를 기준으로 생성됩니다. 키로 열 수 없는 탭, 페이지 또는 AI 버튼은 아예 그려지지 않으며, 누군가 요청을 강제로 보내더라도 서버에서 해당 데이터를 거부합니다.

사용 한도

키의 각 앱에는 UTC 기준 달력 월 또는 달력 연도 단위의 자체 한도가 있습니다. 1 단위로 계산되는 항목은 다음과 같습니다.

AppOne unitFree repeats
tracking고유 화물 1건, 컨테이너, 부킹 또는 B/L 번호같은 기간 내 동일 화물 재조회
freight운임 검색 1건, 구간 및 장비같은 날 동일 검색
schedules스케줄 검색 1건, 경로, 선박 또는 항구같은 날 동일 검색
aiAI assistant에 대한 질문 1개None

예: tracking 한도가 월 300 unique shipments인 경우입니다. 클라이언트 방문자는 해당 월 동안 이 300건의 화물을 원하는 만큼 열고 새로고침할 수 있습니다. 301번째 화물은 다음 달 1일까지 거부됩니다. 앱이 한도에 도달하면 방문자에게 “이 사이트에서는 현재 이 서비스가 일시 중지되었습니다. 에 문의해 주세요.”가 표시됩니다. 같은 키의 다른 앱은 계속 동작합니다. 저희는 앱별 사용량을 확인할 수 있으며, 클라이언트 사이트 변경 없이 언제든 한도를 올릴 수 있습니다.

설치

앱을 표시하는 모든 페이지에 로더를 한 번 넣습니다.

<script src="https://navo24.com/embed.js" async></script>

그다음 앱이 표시될 위치에 컨테이너를 둡니다.

검색 위젯 (홈페이지 히어로 또는 임의의 페이지). 키에 포함된 각 앱, tracking, rates, schedules에 대한 탭과, 키에 포함된 경우 AI mode가 있는 하나의 박스입니다. 앱이 하나뿐이면 탭은 없습니다.

<div
  data-navo-app="search"
  data-navo-key="nve_YOUR_KEY"
  data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>

data-navo-pages를 사용하면 위젯이 방문자를 클라이언트 자체 페이지로 보냅니다. 이 값이 없으면 결과가 위젯 프레임 안에서 바로 열립니다.

추적 페이지 (/track):

<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>

운임 페이지 (/rates):

<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>

선박 스케줄 페이지 (/schedules), 3개 탭 포함: 경로별, 선박별, 항구별:

<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>

모든 앱에서 동일한 data-navo-pages 값을 사용하세요. 그러면 교차 링크, 예를 들어 항해의 “운임 보기” 또는 화물의 “선박 스케줄”이 클라이언트 사이트의 올바른 페이지로 이동합니다.

옵션

AttributeWhat it does
data-navo-appsearch, tracking, freight 또는 schedules.
data-navo-key사이트의 임베드 키.
data-navo-pages클라이언트 사이트의 앱별 페이지 경로에 대한 JSON 맵.
data-navo-heightpx 단위 고정 높이. 기본적으로 프레임은 콘텐츠에 맞춰 늘어납니다. tracking은 전체 지도이며 680 px입니다.
data-navo-syncoff이면 방문자가 앱 안에서 이동해도 페이지 URL을 변경하지 않습니다.
data-navo-theme색상, 폰트, 모서리를 포함한 JSON입니다. Look and feel을 참고하세요.

Content Security Policy가 있는 사이트

사이트가 script-src 또는 frame-src가 포함된 Content-Security-Policy 헤더, 또는 <meta http-equiv>를 보내는 경우 두 항목 모두에 navo24.com을 추가하세요. 그렇지 않으면 브라우저가 로더 또는 프레임을 차단하고 컨테이너가 비어 있게 됩니다.

script-src ... https://navo24.com;
frame-src  ... https://navo24.com;

frame-src 대신 child-src를 사용하는 경우 거기에 추가하세요. 그 외에는 필요하지 않습니다. 앱은 자체 정책 아래 프레임 안에서 데이터, 폰트, 지도를 로드합니다. 누락된 항목이 있으면 브라우저 콘솔에 차단된 directive가 표시됩니다.

분석 및 CRM용 이벤트

방문자가 작업을 수행하면 컨테이너가 DOM 이벤트를 발생시킵니다. 사이트는 이를 Google Analytics, 태그 매니저 또는 CRM으로 보낼 수 있습니다. 이벤트는 버블링되므로 document에 리스너 하나만 두면 페이지의 모든 앱 이벤트를 잡을 수 있습니다.

EventWhenevent.detail
navo:search검색 결과가 반환됨app (tracking, freight, schedules) 및 쿼리: ref, 또는 origin, destination, container
navo:booking예약 요청이 전송됨reference, origin, destination, container, quantity, carrier, price, currency
navo:limit한도로 인해 검색이 중단됨app, code (예: 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>

방문자 연락처 정보는 이벤트에 포함되지 않습니다. 해당 정보는 예약 이메일과 webhook으로만 전송됩니다.

Look and feel

기본적으로 앱은 키에 저장된 클라이언트 브랜드 색상을 사용합니다. 사이트에 더 잘 맞추려면 컨테이너에 data-navo-theme를 추가하세요. 색상, 폰트, 모서리 둥글기, 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>

모든 키는 선택 사항입니다. 유효하지 않은 값은 무시되고, 나머지는 그대로 적용됩니다.

KeyWhat it changesExample
accent버튼, 링크, 활성 탭, 스위치, 포커스 링. hover 및 pressed 색상은 이 값에서 계산됩니다"#e4002b"
text본문 텍스트"#1a1a1a"
muted보조 텍스트: 라벨, 힌트, 날짜"#6b7280"
heading제목, 선사 및 선박명, 지도 라인"#002f6c"
background앱의 페이지 배경. "transparent"를 사용하면 클라이언트 자체 배경이 보입니다"#ffffff"
surface카드, 입력창, 테이블 줄무늬"#f5f7fa"
border테두리와 구분선"#e5e7eb"
success긍정 상태: 배송 완료, 정시, 최저가"#15803d"
radius카드와 패널의 모서리 둥글기, px (0 to 40)8
buttonRadius버튼과 입력창의 모서리 둥글기, px. 999는 pill 형태이며 기본값입니다6
font본문 폰트. 모든 Google Fonts 패밀리는 자동으로 로드됩니다. "system"은 방문자의 시스템 폰트를 사용합니다"Inter"
headingFont제목용 폰트, 규칙은 동일합니다. 없으면 제목은 font를 사용합니다"Playfair Display"
fontCss자체 폰트 스타일시트, @font-face 규칙이 포함된 https:// URL, Google Fonts에 없는 폰트용입니다. 이 경우 font와 headingFont는 해당 파일의 패밀리명을 사용합니다"https://acme.com/fonts/brand.css"
mode어두운 디자인의 사이트에는 "dark""dark"

색상은 hex입니다. #rgb, #rrggbb 또는 #rrggbbaa를 사용할 수 있습니다.

바로 사용할 수 있는 시작점:

<!-- 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"}'

모든 페이지에 하나의 테마. 테마를 키에도 저장할 수 있습니다. 그러면 모든 페이지의 모든 컨테이너가 속성 없이도 해당 테마를 받으며, 나중에 클라이언트 사이트 변경 없이 조정할 수 있습니다. 컨테이너의 data-navo-theme는 여전히 키의 테마보다 우선하며, 키별로 적용됩니다.

테마는 프레임 안의 앱에만 적용됩니다. 클라이언트 자체 페이지는 절대 변경하지 않습니다.

React 및 Next.js, 검색 인덱싱 포함

클라이언트 사이트가 React 또는 Next.js로 구축되어 있고 앱 콘텐츠가 클라이언트 페이지로 인덱싱되어야 할 때 사용합니다. 예를 들어 구간별 페이지, “Shanghai to Hamburg sailing schedule” 같은 페이지입니다.

두 부분으로 구성됩니다.

  1. Snapshot. 클라이언트 서버가 해당 구간의 데이터를 일반 HTML로 저희에게서 가져옵니다. 스케줄 테이블 또는 운임 테이블, 제목, 한 줄 요약, schema.org markup이 포함됩니다. 이를 자체 페이지에 넣습니다. 검색 엔진은 클라이언트 URL에서 클라이언트 콘텐츠로 인덱싱합니다.
  2. App. 브라우저에서는 대화형 앱이 그 위에 마운트됩니다. 검색, 필터, 상세 정보, 예약 기능이 포함됩니다. 스냅샷은 앱 아래 접을 수 있는 테이블로 페이지에 남아 있으므로, 크롤러와 방문자는 같은 콘텐츠를 보게 됩니다.

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이 없으면 응답은 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"
  }
}

페이지의 <title> 및 meta description에는 title과 description을 사용하고, 본문에는 html을 사용하세요. 응답은 30분 동안 캐시할 수 있습니다 (Cache-Control: max-age=1800). 스냅샷은 앱 한도에서 검색 1건으로 계산됩니다. 같은 날 같은 구간은 무료입니다. Tracking에는 스냅샷이 없습니다. 화물은 방문자에게 비공개이기 때문입니다.

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>
      )}
    </>
  );
}

검색 엔진에는 이렇게 보입니다. 페이지 자체의 title과 description, 제목, HTML 안의 전체 항해 또는 운임 테이블, 그리고 Dataset markup입니다. 방문자에게는 이렇게 보입니다. 해당 구간이 이미 열린 라이브 앱과, 그 아래 접힌 테이블로 동일한 결과가 표시됩니다. JavaScript가 꺼진 방문자에게는 열린 테이블이 보입니다. 테이블은 숨겨진 것이 아니라 접혀 있으므로, 페이지는 방문자가 열 수 없는 내용을 크롤러에게 보여주지 않습니다.

스냅샷 HTML은 모든 값이 escape된 상태로 저희 서버에서 제공되므로 안전하게 삽입할 수 있습니다. 표시될 일이 있다면 .navo-snapshot 및 .navo-snapshot-table 클래스로 스타일링하세요.

다른 서버 프레임워크, Remix, Astro, Nuxt, PHP, WordPress도 같은 방식으로 동작합니다. 서버에서 스냅샷을 가져오고, html을 페이지에 출력한 뒤, 그 옆에 컨테이너를 둡니다.

일반 React, 서버 렌더링 없음

검색 인덱싱이 중요하지 않은 경우, 예를 들어 메뉴 뒤의 추적 페이지나 인트라넷에서는 스냅샷 없는 컴포넌트만으로 충분합니다.

로더는 single-page app에서도 동일하게 동작합니다. React, Vue, Svelte에서 컨테이너를 렌더링한 다음 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' }} />

Next.js에서는 client component ('use client')에 넣으세요.

프레임을 사용하는 이유

로더는 navo24.com의 프레임 안에 각 앱을 그립니다. Stripe Checkout, Google Maps embeds, YouTube players가 같은 방식으로 동작하며, 이유도 같습니다.

  • 도메인 잠금. 키 목록에 없는 사이트에서는 브라우저 자체가 앱 표시를 거부합니다 (frame-ancestors). 클라이언트 페이지에 로드되는 스크립트 컴포넌트는 이 방식으로 잠글 수 없습니다.
  • 스타일 충돌 없음. 클라이언트 CSS가 앱을 깨뜨릴 수 없고, 저희 CSS도 클라이언트 사이트에 영향을 주지 않습니다.
  • 클라이언트 작업 없는 업데이트. 새로운 선사, 수정 사항, 기능이 같은 날 모든 사이트에 적용됩니다. 클라이언트 측에서 업그레이드할 것은 없습니다.
  • 검색 엔진. 프레임 안의 콘텐츠는 클라이언트 페이지로 인덱싱되지 않습니다. 지도나 동영상 embed와 동일합니다. 이것이 중요할 때는 서버 렌더링 스냅샷을 추가하세요. React 및 Next.js, 검색 인덱싱 포함을 참고하세요.

방문자는 프레임 안에서 로그인하지 않으므로, 브라우저의 서드파티 쿠키 차단은 영향을 주지 않습니다.

정확한 화면 하나로 연결되는 링크

방문자가 앱에서 작업하는 동안 페이지 URL은 방문자를 따라 변경됩니다. ?navo_app=<app>&navo=<view>. 앱 안의 링크 복사 버튼도 같은 종류의 링크를 만듭니다. 클라이언트 페이지 /rates에서의 예시는 다음과 같습니다.

ViewLink
컨테이너/track?navo_app=tracking&navo=ref%3DZMOU8956106
구간 운임 검색/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
운임 하나위 검색에 %26quote%3D<id> 추가
구간 항해 검색/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
항해 하나위 검색에 %26sailing%3D<id> 추가
선박/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
항구/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

공유된 운임 또는 항해는 라이브 결과에서 사라진 뒤에도 계속 열립니다. 이때 데이터가 가져와진 날짜와 함께 표시됩니다.

예약 요청

운임의 예약을 누르면 요청 양식이 열립니다. 연락처, 회사, 이메일, 전화번호, 컨테이너 수, 화물 준비일, 화물, 메모를 입력합니다. 제출 시:

  • 클라이언트의 예약 주소로 이메일이 전송됩니다. 경로, 장비, 선사, 방문자가 본 가격, 방문자의 연락처 정보가 포함됩니다. Reply-To는 방문자이므로, 클라이언트가 자신의 메일함에서 바로 답장할 수 있습니다;
  • webhook이 설정되어 있으면 동일한 요청이 JSON으로 POST됩니다.
{
  "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" }
  }
}

방문자는 참조번호가 포함된 확인 메시지를 봅니다. 비용은 청구되지 않으며 선사 부킹도 생성되지 않습니다. 클라이언트가 선복을 확인하고 답장합니다.

예약 이메일이나 webhook이 없으면 양식은 데모 상태로 유지되며, 그렇게 안내합니다.

방문자에게 보이는 것과 보이지 않는 것

  • 선사명과 로고, 가격, transit time, 유효기간, 운임 포함 항목.
  • 선사명이 없는 운임은 클라이언트 로고와 함께 ” Select”로 표시됩니다.
  • 운임 소스와 플랫폼은 절대 표시되지 않습니다. 데이터가 브라우저에 도달하기 전에 저희 서버에서 제거됩니다.

보안

도메인 잠금. 앱 페이지는 키의 도메인만 나열한 Content-Security-Policy: frame-ancestors로 응답하므로, 브라우저는 다른 곳에서 표시하는 것을 거부합니다. 데이터 요청에는 키와 부모 페이지의 host가 포함되며, host가 목록에 없으면 거부됩니다. 다른 사이트에 복사한 키는 그곳에서 동작하지 않습니다.

한도. 키의 각 앱에는 자체 월간 또는 연간 한도가 있습니다. 사용 한도를 참고하세요. 그 외에도 모든 키에는 월 50,000 requests의 안전 상한, 전체 사이트 기준 분당 600 requests의 상한이 있습니다. 따라서 한 사이트의 트래픽 급증이 다른 사이트의 앱을 느리게 만들 수 없습니다. 요청 시 상향 가능합니다. 또한 스크립트 남용을 막기 위한 방문자별 rate limit이 있습니다. 이를 초과하면 앱은 짧은 “다시 시도해 주세요” 메시지를 표시하고 navo:limit을 발생시킵니다.

메시지. 프레임과 로더는 postMessage로 통신하며, 각 측은 상대의 정확한 origin으로만 전송합니다. 프레임은 클라이언트 페이지로, 로더는 navo24.com으로 보냅니다. 검색 세부 정보는 절대 *로 전송되지 않습니다.

교체. 키가 유출되거나 사이트 소유자가 변경되면 새 키를 발급하고 기존 키는 즉시 중지합니다.

출시 전 테스트

운영 도메인과 함께 스테이징 도메인을 보내주세요. 개발자 머신용이면 localhost:<port>도 가능합니다. 둘 다 같은 키에 둘 수 있습니다.

체크리스트

  1. 클라이언트가 이름, 도메인, 로고, 색상, 예약 이메일, 구매한 앱, AI mode 켜기 또는 끄기, 각 앱의 한도, 선택적으로 webhook 및 페이지 경로를 보냅니다.
  2. 저희가 키를 만들고 스니펫을 보냅니다.
  3. 클라이언트가 먼저 스테이징에 embed.js와 컨테이너를 추가합니다.
  4. 클라이언트가 확인합니다. search → tracking, rates → details → booking, 테스트 이메일 도착, 공유 링크가 자사 사이트에서 열림. 엄격한 CSP가 있으면 브라우저 콘솔에서 차단된 navo24.com을 확인합니다.
  5. 클라이언트가 운영 도메인을 추가하고, 아직 목록에 없다면, 라이브로 전환합니다.