API خدمات حمل‌ونقل ایران

API استعلام بارنامه، نرخ کرایه و اطلاعات ناوگان

داده‌های ساختاریافته حمل‌ونقل را با REST API و پاسخ JSON مستقیماً به ERP، FMS، TMS یا پلتفرم خود متصل کنید.

از جاده تا داده.
ساخت حساب و دریافت کلید Sandbox مشاهده مستندات
مشاهده تعرفه‌ها
  • REST API
  • JSON
  • Sandbox
  • OpenAPI
  • API Key

Sandbox نامحدود. درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

اولین درخواست شماSandbox
POST/api/v1/waybills/by-plate
# Use your test key. Example inputs are synthetic; no automatic retry.
# Replace YOUR_API_KEY with a test key on your server.
curl --request POST 'https://api.bar-ban.ir/api/v1/waybills/by-plate' \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Idempotency-Key: example-waybill-plate-001" \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{
  "plateLeft": "82",
  "plateLetter": "ع",
  "plateRight": "117",
  "plateCity": "11"
}'
دریافت OpenAPIمستندات این سرویس

ورودی‌ها آموزشی‌اند. پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود. کلید را فقط در سرور خود نگه دارید.

همراه کسب‌وکارهای حمل‌ونقل و صنعت

جای کسب‌وکار شما اینجاست

به جمع همراهان باربان بپیوندید
۰۱ — مرجع سرویس‌ها

یک اتصال، مجموعه‌ای از داده‌های حمل‌ونقل

سرویس‌های موردنیاز نرم‌افزارهای حمل‌ونقل، مدیریت ناوگان و لجستیک را از یک API یکپارچه دریافت کنید.

۱۹ سرویس فعال۷ گروه دادهREST / JSON

۱۰ سرویس فعال

بارنامه و رهگیری

بارنامه، آخرین بارنامه قابل دریافت، رهگیری و اسناد مرتبط

مستندات API بارنامه و رهگیری ۱ سرویس فعال

نرخ کرایه حمل بار

نرخ عرف حمل برای مسیر و مشخصات محموله

مستندات API نرخ کرایه حمل بار ۲ سرویس فعال

راننده

اطلاعات راننده با کارت هوشمند یا کد ملی

مستندات API راننده ۲ سرویس فعال

ناوگان

اطلاعات پایه و کامل ناوگان

مستندات API ناوگان ۱ سرویس فعال

بیمه بار

استعلام بیمه‌نامه با شناسه شرکت و شماره بیمه‌نامه

مستندات API بیمه بار ۲ سرویس فعال

اشخاص

اطلاعات اشخاص حقیقی و حقوقی

مستندات API اشخاص ۱ سرویس فعال

نشانی و موقعیت

نشانی و مختصات مرتبط با کدپستی

مستندات API نشانی و موقعیت
در پلن‌های نتیجه‌دار

فقط برای نتیجه هزینه می‌پردازید

این شیوه محاسبه برای پلن‌های پایلوت، شروع، رشد، مقیاس است. فقط پاسخ زنده موفق و دارای داده در سرویس سهمیه‌بر، از سهمیه کم می‌شود.

شرایط پلن‌ها را ببینید

نتیجه دریافت شد ← کسر از سهمیه

بدون نتیجه ← بدون کسر سهمیه

برای کلید زنده در پلن نتیجه‌دار؛ سایر پلن‌ها می‌توانند شیوه محاسبه متفاوتی داشته باشند.
۰۲ — از تست تا اتصال واقعی

اولین درخواست API خود را ارسال کنید

سرویس موردنظر را انتخاب کنید، درخواست و پاسخ را در Sandbox آزمایش کنید و سپس اتصال Production را آماده کنید.

  1. ۱

    حساب خود را بسازید و کلید Sandbox بگیرید

    وارد حساب شوید، فضای سازمانی بسازید و یک اشتراک یا دوره آزمایشی واجد شرایط انتخاب کنید.

  2. ۲

    در Sandbox تست کنید

    پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود. Sandbox نامحدود. درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

  3. ۳

    به Production بروید

    پس از بررسی مجوز استفاده از داده و اشتراک، کلید زنده بسازید. پاسخ واقعی، مصرف و خطاها را در اتصال خود مدیریت کنید.

ساخت حساب و دریافت کلید Sandbox مشاهده مستندات
راهنمای قدم‌به‌قدم اتصال
یکپارچه‌سازی با دید روشن

چرا API باربان؟

یکپارچه به‌جای چند اتصال

قرارداد سرویس‌های حمل‌ونقل، احراز هویت و ثبت مصرف را در یک محیط دنبال کنید.

تست پیش از داده واقعی

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.

کنترل مصرف و کلیدها

سهمیه، سقف دقیقه‌ای، کلیدها و سابقه مصرف سازمان را از پنل بررسی کنید.

همکاری در سطح سازمان

اعضا، نقش‌ها، دسترسی کلیدها و صورتحساب سازمان را در فضای مشترک مدیریت کنید.

داده در جریان کار

API باربان کجای کسب‌وکار شما قرار می‌گیرد؟

ERP / TMS

درخواست ← JSON ← فرایند عملیاتی

داده را در فرایند داخلی دریافت کنید و ورود دستی اطلاعات را کاهش دهید.

مشاهده راهکار ERP / TMS
راهکارهای باربان برای کسب‌وکارها
قرارداد روشن، خطای قابل پیگیری

ساخته‌شده برای توسعه‌دهندگان

نمونه‌های cURL، C#، Node.js و Python، ورودی هر سرویس و راهنمای تفسیر پاسخ را در مستندات ببینید. برای پیگیری عملیات از شناسه درخواست استفاده کنید.

مشاهده مستندات API
۰۳ — تعرفه خدمات API

متناسب با مصرف سازمان شما

تعرفه و سهمیه جاری از کاتالوگ باربان؛ مستقل از سکه حساب شخصی و کرایه حمل. مبلغ نهایی و مالیات پیش از پرداخت در صورتحساب مشخص می‌شود.

دوره پرداخت را انتخاب کنید
دوره پرداخت

هزینه ماهانه را مقایسه کنید؛ مبلغ صرفه‌جویی با پرداخت سالانه در هر پلن مشخص است.

شروع سریع

پایلوت

مناسب ارزیابی اولیه API و اجرای پروژه‌های آزمایشی

۶٬۴۵۰٬۰۰۰ تومان / ماه، پیش از مالیات

۵۰۰ درخواست در ماه

۱۲٬۹۰۰ تومان میانگین هر درخواست با مصرف کامل سهمیه

۲ ماه رایگان
قیمت سالانه
۶۴٬۵۰۰٬۰۰۰ تومان
صرفه‌جویی سالانه
۱۲٬۹۰۰٬۰۰۰ تومان
معادل ماهانه
۵٬۳۷۵٬۰۰۰ تومان
در مقایسه با ۱۲ پرداخت ماهانه ۶٬۴۵۰٬۰۰۰ تومان
  • Sandbox نامحدود
  • ۲ کلید API
  • پشتیبانی استاندارد
  • گزارش مصرف
جزئیات فنی و شرایط

محاسبه بر اساس درخواست‌های نتیجه‌دار

  • Sandbox نامحدود
  • گزارش مصرف
  • مستندات کامل API
  • ۵ درخواست در دقیقه
  • ۲ کلید API
  • پشتیبانی استاندارد

۱۵٬۰۰۰ تومان برای هر درخواست مازاد

Sandbox نامحدود

درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.
  • حداکثر ۱٬۰۰۰ درخواست مازاد در ماه
  • فهرست IP مجاز: ندارد
  • حداقل تعهد: ۱ ماه
شروع اتصال
شروع سریع

شروع

مناسب تیم‌هایی که اتصال API را شروع می‌کنند

۱۲٬۹۰۰٬۰۰۰ تومان / ماه، پیش از مالیات

۱٬۰۰۰ درخواست در ماه

۱۲٬۹۰۰ تومان میانگین هر درخواست با مصرف کامل سهمیه

۲ ماه رایگان
قیمت سالانه
۱۲۹٬۰۰۰٬۰۰۰ تومان
صرفه‌جویی سالانه
۲۵٬۸۰۰٬۰۰۰ تومان
معادل ماهانه
۱۰٬۷۵۰٬۰۰۰ تومان
در مقایسه با ۱۲ پرداخت ماهانه ۱۲٬۹۰۰٬۰۰۰ تومان
  • Sandbox نامحدود
  • ۲ کلید API
  • پشتیبانی استاندارد
  • گزارش مصرف
۷ روز آزمایش پیش از پرداخت · تا ۱۰۰ درخواست واقعی

ویژه اولین اشتراک سازمان؛ هنگام ثبت، صورتحساب پلن هم صادر می‌شود.

آزمایش برای سازمانی است که قبلاً اشتراک نداشته؛ فعال‌شدن آن پس از ثبت اشتراک واجد شرایط است. دوره آزمایشی مصرف مازاد ندارد. هنگام ثبت اشتراک، صورتحساب پلن نیز صادر می‌شود؛ مبلغ و سررسید را پیش از ثبت بررسی کنید.

شروع آزمایش
جزئیات فنی و شرایط

محاسبه بر اساس درخواست‌های نتیجه‌دار

  • Sandbox نامحدود
  • گزارش مصرف
  • مستندات کامل API
  • ۵ درخواست در دقیقه
  • ۲ کلید API
  • پشتیبانی استاندارد

۱۵٬۰۰۰ تومان برای هر درخواست مازاد

Sandbox نامحدود

درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.
  • حداکثر ۲٬۰۰۰ درخواست مازاد در ماه
  • فهرست IP مجاز: ندارد
  • حداقل تعهد: ۱ ماه
شروع اتصال
محبوب‌ترین

رشد

مناسب شرکت‌های حمل‌ونقل، FMS و نرم‌افزارهای عملیاتی

۴۹٬۹۰۰٬۰۰۰ تومان / ماه، پیش از مالیات

۶٬۰۰۰ درخواست در ماه

۸٬۳۱۷ تومان میانگین هر درخواست با مصرف کامل سهمیه

۲ ماه رایگان
قیمت سالانه
۴۹۹٬۰۰۰٬۰۰۰ تومان
صرفه‌جویی سالانه
۹۹٬۸۰۰٬۰۰۰ تومان
معادل ماهانه
۴۱٬۵۸۳٬۳۳۳ تومان
در مقایسه با ۱۲ پرداخت ماهانه ۴۹٬۹۰۰٬۰۰۰ تومان

۳۵٪ اقتصادی‌تر از پایلوت با مصرف کامل سهمیه

  • Sandbox نامحدود
  • ۵ کلید API
  • پشتیبانی اولویت‌دار
  • گزارش مصرف
جزئیات فنی و شرایط

محاسبه بر اساس درخواست‌های نتیجه‌دار

مناسب برای: شرکت‌های حمل‌ونقل، FMS، ERP و نرم‌افزارهای پرتراکنش

  • Sandbox نامحدود
  • گزارش مصرف
  • Rate Limit بالاتر
  • مستندات کامل API
  • ۲۰ درخواست در دقیقه
  • ۵ کلید API
  • پشتیبانی اولویت‌دار
  • سطح خدمت استاندارد

۹٬۵۰۰ تومان برای هر درخواست مازاد

Sandbox نامحدود

درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.
  • حداکثر ۴٬۰۰۰ درخواست مازاد در ماه
  • فهرست IP مجاز: ندارد
  • حداقل تعهد: ۱ ماه
انتخاب پلن رشد
مناسب مصرف بالا

مقیاس

مناسب پلتفرم‌ها و کسب‌وکارهای با مصرف بالا

۸۹٬۹۰۰٬۰۰۰ تومان / ماه، پیش از مالیات

۱۵٬۰۰۰ درخواست در ماه

۵٬۹۹۳ تومان میانگین هر درخواست با مصرف کامل سهمیه

۲ ماه رایگان
قیمت سالانه
۸۹۹٬۰۰۰٬۰۰۰ تومان
صرفه‌جویی سالانه
۱۷۹٬۸۰۰٬۰۰۰ تومان
معادل ماهانه
۷۴٬۹۱۶٬۶۶۷ تومان
در مقایسه با ۱۲ پرداخت ماهانه ۸۹٬۹۰۰٬۰۰۰ تومان

۵۳٪ اقتصادی‌تر از پایلوت با مصرف کامل سهمیه

  • ۱۵٬۰۰۰ استعلام نتیجه‌دار
  • ۱۰ کلید API
  • پشتیبانی اولویت‌دار
  • Sandbox نامحدود
جزئیات فنی و شرایط

محاسبه بر اساس درخواست‌های نتیجه‌دار

مناسب برای: پلتفرم‌های بزرگ، FMSها، TMSها و سامانه‌های پرتراکنش

  • ۱۵٬۰۰۰ استعلام نتیجه‌دار
  • Sandbox نامحدود
  • IP Whitelisting
  • Rate Limit بالاتر
  • گزارش مصرف
  • ۶۰ درخواست در دقیقه
  • ۱۰ کلید API
  • پشتیبانی اولویت‌دار
  • سطح خدمت اولویت‌دار

۷٬۰۰۰ تومان برای هر درخواست مازاد

Sandbox نامحدود

درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.
  • حداکثر ۱۰٬۰۰۰ درخواست مازاد در ماه
  • فهرست IP مجاز: دارد
  • حداقل تعهد: ۱ ماه
انتخاب پلن مقیاس
راهکار اختصاصی

سازمانی

برای سازمان‌ها و پلتفرم‌های با حجم مصرف یا نیازهای اختصاصی

تماس با فروش

از ۲۵٬۰۰۰+ درخواست در ماه

  • ظرفیت متناسب با نیاز و توافق سازمان
  • کلیدهای API متناسب با نیاز سازمان
  • پشتیبانی اختصاصی
  • SLA سازمانی
جزئیات فنی و شرایط

مناسب برای: سازمان‌ها

  • ظرفیت اختصاصی
  • IP Whitelisting
  • Rate Limit اختصاصی
  • قرارداد سازمانی
  • ظرفیت متناسب با نیاز و توافق سازمان
  • کلیدهای API متناسب با نیاز سازمان
  • پشتیبانی اختصاصی
  • SLA سازمانی

مصرف مازاد طبق قرارداد

Sandbox طبق پیشنهاد سازمانی

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود.

  • فهرست IP مجاز: دارد
  • حداقل تعهد: ۳ ماه
دریافت پیشنهاد سازمانی

در پلن‌های نتیجه‌دار، فقط استعلام زنده با پاسخ موفق و داده از سهمیه کم می‌شود. در پلن‌های «همه درخواست‌ها»، درخواست پذیرفته‌شده بدون نتیجه هم می‌تواند سهمیه مصرف کند. امکان استفاده و سهمیه Sandbox را در شرایط هر پلن ببینید؛ شرایط اشتراک خریداری‌شده مبنای مصرف است.

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

برای مصرف بالا یا نیازهای سازمانی؟

نیاز مصرف، تعداد کلیدها و دسترسی اعضای سازمان را با تیم فروش بررسی کنید. ظرفیت و شرایط پشتیبانی بر اساس پلن یا پیشنهاد تأییدشده مشخص می‌شوند.

دریافت پیشنهاد سازمانی آشنایی با خدمات سازمانی

امنیت و کنترل در سطح سازمانی

  • کلیدهای محدود به Scope و قابل لغو
  • مدیریت اعضا و نقش‌های سازمان
  • محدودیت تعداد درخواست در دقیقه
  • شناسه درخواست و تکرار امن با Idempotency-Key
  • تفکیک کلید آزمایشی و زنده
راهنمای امنیت کلید API
پیش از اتصال

سوالات متداول API

API باربان چیست؟

باربان یک پلتفرم داده حمل‌ونقل است. API باربان داده‌های حمل‌ونقل را با REST API و پاسخ JSON در اختیار نرم‌افزارهای سازمانی قرار می‌دهد؛ دسترسی به هر سرویس به کلید، scope و وضعیت اشتراک وابسته است.

API باربان چه اطلاعاتی ارائه می‌کند؟

سرویس‌های فعال فعلی: بارنامه و رهگیری، نرخ کرایه حمل بار، راننده، ناوگان، بیمه بار، اشخاص، نشانی و موقعیت. فیلدها و ورودی‌های هر سرویس در مستندات آن آمده‌اند.

چطور کلید API دریافت کنم؟

وارد حساب شوید و در فضای سازمانی، سازمان و اشتراک قابل استفاده ایجاد یا انتخاب کنید. در بخش کلیدها، کلید آزمایشی یا زنده با scope موردنیاز بسازید. مقدار کامل کلید فقط هنگام صدور یا چرخش نمایش داده می‌شود.

Sandbox چیست؟

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود. Sandbox نامحدود. درخواست‌های Sandbox از سهمیه Production کسر نمی‌شوند؛ محدودیت نرخ درخواست همچنان برقرار است.

تفاوت Sandbox و Production چیست؟

پاسخ‌های Sandbox آزمایشی و ساختگی‌اند؛ سرویس عملیاتی راهداری فراخوانی نمی‌شود. کلید زنده درخواست واقعی را با شرایط اشتراک اجرا می‌کند.

آیا استعلام بدون نتیجه از سهمیه کم می‌شود؟

در پلن‌های نتیجه‌دار، فقط استعلام زنده با پاسخ موفق و داده از سهمیه کم می‌شود. در پلن‌های «همه درخواست‌ها»، درخواست پذیرفته‌شده بدون نتیجه هم می‌تواند سهمیه مصرف کند. پلن‌های نتیجه‌دار فعلی: پایلوت، شروع، رشد، مقیاس.

Rate Limit چیست؟

حداکثر تعداد درخواست پذیرفته‌شده در دقیقه طبق اشتراک است. عبور از سقف، پاسخ 429 می‌دهد. هدر X-RateLimit-Limit در پاسخ‌های پذیرفته‌شده سقف را نشان می‌دهد؛ سهمیه دوره محدودیتی جداگانه است.

آیا می‌توان چند کلید API ایجاد کرد؟

بله؛ تعداد کلیدها به سقف پلن بستگی دارد. برای هر کلید می‌توانید scopeهای موردنیاز را انتخاب کنید و برای لغو یا جایگزینی کلید با پشتیبانی هماهنگ کنید.

API نرخ کرایه چه اطلاعاتی نیاز دارد؟

کد مبدأ، مقصد، بارگیر و کالا، وزن مثبت به تن، کمیسیون نامنفی به درصد و وضعیت بار ترافیکی لازم است. کدها را از داده‌های مرجع بگیرید. Price پاسخ، نرخ عرف حمل به ریال است و هزینه استفاده از API نیست.

آیا برای مصرف بالا پلن سازمانی وجود دارد؟

برای بررسی مصرف بالا و شرایط سازمانی از مسیر تماس با فروش درخواست پیشنهاد دهید. ظرفیت، تعداد کلیدها و پشتیبانی به پیشنهاد و شرایط تأییدشده وابسته‌اند.

آیا امکان استفاده در ERP، FMS یا TMS وجود دارد؟

بله؛ درخواست‌ها را از سرور سامانه خود با هدر X-API-Key ارسال و پاسخ JSON را در فرایند داخلی پردازش کنید. کلید محرمانه نباید در کد مرورگر یا اپ عمومی قرار بگیرد.

دوره آزمایشی چه شرایطی دارد؟

آزمایش برای سازمانی است که قبلاً اشتراک نداشته؛ فعال‌شدن آن پس از ثبت اشتراک واجد شرایط است. دوره آزمایشی مصرف مازاد ندارد. هنگام ثبت اشتراک، صورتحساب پلن نیز صادر می‌شود؛ مبلغ و سررسید را پیش از ثبت بررسی کنید.

از جاده تا داده

آماده اتصال هستید؟

کلید Sandbox بسازید، ساختار اولین درخواست را بررسی کنید و پس از آماده‌شدن اتصال، از کلید زنده استفاده کنید.

ساخت حساب و دریافت کلید Sandbox مشاهده مستندات
تماس با فروش