SDK 및 도구
Navo24 기반 개발에 필요한 모든 것.
모든 제품의 OpenAPI 명세, 명령 하나로 생성하는 원하는 언어의 타입 지정 클라이언트, 바로 쓰는 Postman 컬렉션, AI 어시스턴트용 MCP 서버, 그리고 웹훅 수신기 테스트 버튼까지 제공합니다.
시스템이 Navo24와 통신할 방식을 선택하세요.
REST API
직접 작성한 코드에서 API 호출
백엔드에서 컨테이너, 항공 화물 운송장 또는 구간을 Bearer 키와 함께 https://api.navo24.com/v1/<product> 로 보내면 JSON으로 응답을 받습니다. 생성된 클라이언트, Postman 컬렉션 또는 일반 HTTP를 사용하세요.
빠른 시작 가이드 보기MCP
AI 어시스턴트가 도구를 호출하도록
Claude, Cursor, ChatGPT 등 모든 MCP 클라이언트가 Navo24 MCP 서버에 연결해 추적, 스케줄, 운임, 적재 계획을 도구로 호출합니다. 클라이언트 코드를 작성할 필요가 없습니다.
MCP 빠른 시작클라이언트 라이브러리
원하는 언어의 타입 지정 클라이언트를 명령 하나로.
각 제품은 api.navo24.com 을 이미 가리키는 OpenAPI 3 명세를 공개합니다. OpenAPI Generator를 실행하면 모델, 섹션별 API 클래스, 인증 처리가 생성됩니다. 아래 6개 대상은 모두 매 릴리스 전에 자체 명세로 직접 생성해 검증합니다.
npm, PyPI 등 레지스트리용 공식 Navo24 패키지는 아직 배포되지 않았습니다. 그전까지는 클라이언트를 직접 생성하세요. 다시 생성할 때마다 API와 항상 동기화됩니다.
직접 작성한 fetch 래퍼로 따라 하는 가이드npx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g typescript-fetch \
-o ./navo24-tracking-tsnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g python \
-o ./navo24-tracking-pynpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g php \
-o ./navo24-tracking-phpnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g java \
-o ./navo24-tracking-javanpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g csharp \
-o ./navo24-tracking-dotnetnpx @openapitools/openapi-generator-cli generate \
-i https://navo24.com/developers/openapi/tracking.json \
-g go \
-o ./navo24-tracking-gotracking.json 을 air.json, schedules.json, loading.json 또는 rates.json 으로 바꾸면 다른 제품의 클라이언트를 받을 수 있습니다. Node.js 18 이상과 Java 11 이상이 필요하며, openapitools/openapi-generator-cli Docker 이미지도 동일한 플래그를 사용합니다.
OpenAPI 및 Postman
모든 제품의 명세와 컬렉션.
코드 생성이나 계약 테스트용으로 명세를 내려받거나, 컬렉션을 가져와 1분 안에 첫 요청을 보내세요. apiKey 변수에 키를 설정하면 되며, baseUrl 은 이미 입력되어 있습니다.
Bruno와 Insomnia에서도 같은 컬렉션이나 OpenAPI 파일을 바로 가져올 수 있습니다.
도구
모든 키와 함께 제공되는 추가 도구.
코드 샘플
레퍼런스의 모든 엔드포인트에 curl, JavaScript, Python으로 바로 복사해 쓸 수 있는 요청과 실제 응답이 포함되어 있습니다.
레퍼런스 보기MCP 서버
제품별 MCP 서버와 함께 거리, CO2e, 선박, 항공편을 위한 mcp.navo24.com 을 제공합니다. API와 같은 키를 사용합니다.
Navo24 MCP 서버웹훅 테스트 전송
어떤 제품에서든 서명된 테스트 이벤트를 수신기로 보내 헤더, 엔벌로프, 재시도를 처음부터 끝까지 확인하세요.
웹훅 가이드임베드 앱
script 태그 하나와 도메인 제한 키로 고객 사이트에 자체 브랜드로 추적, 운임, 스케줄을 제공합니다.
앱 임베드하기DCSA 이벤트 피드
이미 표준을 지원하는 시스템을 위한 DCSA 형식의 Track & Trace 이벤트입니다.
DCSA 피드오류 및 요청 한도
모든 제품에 공통인 오류 엔벌로프, 분기 처리에 쓸 상태 코드, 재시도 백오프 방식을 안내합니다.
오류 및 한도Webhooks
수신기 테스트
웹훅을 만든 뒤 ping을 요청하세요. 실제 이벤트와 같은 경로로 전달되며, 헤더, 서명, 재시도 단계도 모두 동일합니다.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"