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-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-goبرای دریافت محصولات دیگر، به جای 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 را مستقیماً وارد میکنند.
ابزارها
ابزارهای بیشتری که با هر کلید ارائه میشوند.
نمونه کدها
هر endpoint در مرجع، درخواستهای آماده کپی با curl، JavaScript و Python به همراه پاسخهای واقعی دارد.
مرور مرجعسرورهای MCP
یک سرور MCP برای هر محصول، بهعلاوه mcp.navo24.com برای مسافت، CO2e، کشتیها و پروازها. همان کلید API.
سرور MCP از Navo24ارسال آزمایشی وبهوک
از هر محصولی یک رویداد آزمایشی امضاشده به گیرنده خود بفرستید و هدرها، پوشش پیام و تلاشهای مجدد را از ابتدا تا انتها بررسی کنید.
راهنمای وبهوکهااپلیکیشنهای قابل جاسازی
رهگیری، نرخها و برنامه حرکت کشتیها در سایت مشتری با برند خودش، با یک تگ script و یک کلید محدود به دامنه.
جاسازی اپلیکیشنهافید رویداد DCSA
رویدادهای Track & Trace در قالب DCSA، برای سیستمهایی که از قبل با این استاندارد کار میکنند.
فید DCSAخطاها و محدودیت نرخ
یک پوشش خطای یکسان در همه محصولات، کدهای وضعیتی که باید بر اساس آنها تصمیم گرفت و نحوه عقبنشینی تدریجی در تلاشهای مجدد.
خطاها و محدودیتهاWebhooks
گیرنده خود را آزمایش کنید
یک وبهوک بسازید، سپس از ما یک ping بخواهید. این پیام همان مسیر یک رویداد واقعی را طی میکند: همان هدرها، همان امضا، همان ترتیب تلاشهای مجدد.
POST /webhooks/{id}/testcurl -X POST https://api.navo24.com/v1/tracking/webhooks/{id}/test \
-H "Authorization: Bearer $NAVO24_API_KEY"