Skip to content
Navo24Navo24

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-ts

tracking.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 파일을 바로 가져올 수 있습니다.

도구

모든 키와 함께 제공되는 추가 도구.

Webhooks

수신기 테스트

웹훅을 만든 뒤 ping을 요청하세요. 실제 이벤트와 같은 경로로 전달되며, 헤더, 서명, 재시도 단계도 모두 동일합니다.

POST /webhooks/{id}/test
curl
curl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
  -H "Authorization: Bearer $NAVO24_API_KEY"