نگارش و بازبینی: باربان · آخرین بازبینی:
تشخیص ورودی و دسترسی
کد خطا تعیین می‌کند چه اقدامی لازم است. invalid_plate یا invalid_parameter به ورودی مربوط‌اند؛ 401 به شناسایی کلید و 403 به مجوز، scope یا محدودیت IP مربوط است. در api_ip_not_allowed، IP خروجی سرور اتصال را با فهرست مجاز کلید بررسی کنید. rmto_access_denied رد دسترسی باربان نزد راهداری است؛ آن را پایان نشست کاربر یا نبود بارنامه تلقی نکنید.
تفکیک محدودیت نرخ و سهمیه
در پاسخ 429، rate_limit_exceeded را از quota_exceeded جدا کنید. برای سقف دقیقه‌ای، تعداد درخواست هم‌زمان را کاهش دهید؛ برای پایان سهمیه، شرایط اشتراک و امکان مصرف مازاد را بررسی کنید. وجود Retry-After را بدون مشاهده پاسخ فرض نکنید.
درخواست تکراری و وضعیت نامشخص
Idempotency-Key برای پیگیری همان عملیات است. پاسخ تکمیل‌شده با همان کلید API، مسیر، ورودی و شناسه بازپخش می‌شود. request_in_progress پردازش در جریان و idempotency_conflict استفاده ناسازگار از شناسه است. قطع شبکه، شکست قطعی عملیات را ثابت نمی‌کند؛ پیش از شروع درخواست تازه، وضعیت قبلی را بررسی کنید.
پیگیری خطای سرویس
upstream_timeout پایان مهلت پاسخ، upstream_unavailable مشکل ارتباط و upstream_invalid_response پاسخ خارج از قرارداد را نشان می‌دهند. upstream_no_response یعنی اتصال این درخواست بدون پاسخ بسته شده است؛ نبود بارنامه یا قطعی کل سرویس از آن قطعی نتیجه نمی‌شود. برای پیگیری، زمان، مسیر سرویس، وضعیت HTTP، کد خطا و شناسه درخواست کافی است؛ کلید محرمانه و اطلاعات راننده یا محموله را در گزارش عمومی ننویسید.
منبع و ادامه بررسی
این راهنما بر اساس قرارداد جاری خدمات باربان نوشته شده است؛ نتیجه هر استعلام و شرایط استفاده را در خدمت مربوط بررسی کنید.