نگارش و بازبینی: باربان · آخرین بازبینی:
جای استعلام در عملیات حمل
استعلام بارنامه را در مرحله‌ای از جریان حمل قرار دهید که تیم شما به تطبیق اطلاعات نیاز دارد؛ برای نمونه پیش از بررسی مدارک سفر. داده پلاک و شناسه‌های سند را با قالب قرارداد API نگه دارید و زمان استعلام را جدا از زمان صدور بارنامه ثبت کنید.
نمایش و تطبیق داده‌ها
در سامانه ناوگان، شماره بارنامه، مسیر، راننده و محموله موجود در پاسخ را کنار اطلاعات سفر نمایش دهید. مغایرت نیازمند بررسی مسئول عملیات است؛ وجود یک پاسخ یا تطابق یک فیلد، به‌تنهایی تأیید تمام شرایط حمل نیست.
تفکیک محیط و سطح دسترسی
کلیدهای پروژه و محیط آزمایشی را از محیط عملیاتی جدا کنید. مالک و مدیر می‌توانند عضو ثبت‌نام‌شده را اضافه کنند، نقش عضو دیگر را تغییر دهند یا دسترسی او را قطع کنند. مدیریت کلید برای مالک، مدیر و توسعه‌دهنده مجاز است؛ دسترسی مالی مستقل است. انقضای کلید و در قراردادهای دارای این قابلیت، فهرست IP مجاز را متناسب با اتصال تنظیم کنید.
حدود نتیجه و داده‌های غایب
مبدأ و مقصد بارنامه، موقعیت زنده خودرو نیستند. نرخ عرف حمل نیز جای توافق نهایی حمل را نمی‌گیرد. در طراحی نرم‌افزار، نتیجه خالی و خطای ارتباط را از داده معتبر جدا کنید و برای اطلاعات غایب، مقدار تأییدشده یا ساختگی نمایش ندهید.
شاخص‌های گزارش ناوگان را چگونه تعریف کنیم؟
تعداد درخواست‌های استعلام، تعداد سفر یا تعداد بارنامه یکتا نیست؛ یک پلاک ممکن است چند بار استعلام شود و همان سند را برگرداند. برای گزارش، زمان استعلام و تاریخ صدور را جدا نگه دارید، نتیجه خالی و خطا را مستقل بشمارید و دریافت HTTP موفق را معادل مصرف سهمیه نگیرید. مصرف را با سوابق درخواست و سهمیه سازمان تطبیق دهید. پاسخ آخرین بارنامه نیز جای تاریخچه کامل سفرهای ناوگان را نمی‌گیرد.
منبع و ادامه بررسی
این راهنما بر اساس قرارداد جاری خدمات باربان نوشته شده است؛ نتیجه هر استعلام و شرایط استفاده را در خدمت مربوط بررسی کنید.