Skip to content
Navo24Navo24

SDKها و ابزارها

هر آنچه برای ساختن روی Navo24 نیاز دارید.

مشخصات OpenAPI برای هر محصول، یک کلاینت تایپ‌شده به زبان شما با یک دستور، مجموعه‌های آماده Postman، سرورهای MCP برای دستیارهای هوش مصنوعی و یک دکمه آزمایش برای گیرنده وب‌هوک شما.

انتخاب کنید سیستم شما چگونه با Navo24 ارتباط برقرار کند.

REST API

API را از کد خودتان فراخوانی کنید

بک‌اند شما یک کانتینر، بارنامه هوایی یا مسیر را با یک کلید bearer به https://api.navo24.com/v1/<product> می‌فرستد و JSON دریافت می‌کند. از یک کلاینت تولیدشده، مجموعه Postman یا HTTP ساده استفاده کنید.

راهنمای شروع سریع را بخوانید

MCP

بگذارید دستیار هوش مصنوعی ابزارها را فراخوانی کند

Claude، Cursor، ChatGPT یا هر کلاینت MCP به یک سرور MCP از Navo24 متصل می‌شود و رهگیری، برنامه حرکت کشتی‌ها، نرخ‌ها و برنامه‌ریزی بارگیری را به‌عنوان ابزار فراخوانی می‌کند. نیازی به نوشتن کد کلاینت نیست.

شروع سریع MCP

کتابخانه‌های کلاینت

یک کلاینت تایپ‌شده به زبان شما، با یک دستور.

هر محصول یک مشخصات OpenAPI 3 منتشر می‌کند که از قبل به api.navo24.com اشاره دارد. OpenAPI Generator را روی آن اجرا کنید تا مدل‌ها، یک کلاس API برای هر بخش و مدیریت احراز هویت را دریافت کنید. ما هر شش هدف زیر را پیش از هر انتشار از مشخصات خودمان تولید می‌کنیم.

بسته‌های رسمی Navo24 برای npm، PyPI و دیگر مخازن هنوز منتشر نشده‌اند. تا آن زمان، کلاینت را خودتان بسازید: هر بار که آن را دوباره تولید کنید، با 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+ نیاز دارد؛ ایمیج Docker با نام openapitools/openapi-generator-cli همان پارامترها را می‌پذیرد.

OpenAPI و Postman

مشخصات و مجموعه‌ها برای هر محصول.

مشخصات را برای تولید کد یا تست‌های قرارداد دانلود کنید، یا مجموعه را وارد کنید و نخستین درخواست خود را در یک دقیقه بفرستید. متغیر 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"