پلتفرم عامل‌ها و API Road User Tools

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

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

محدودیت های درخواستی

بدنه درخواست JSON محدود به16 KiB. ورودی‌ها قبل از محاسبه اعتبارسنجی می‌شوند، از جمله واحدهای پشتیبانی‌شده، مقادیر عددی محدود، فیلدهای غیرمنتظره و محدوده‌های مقادیر مانند فواصل غیرمنفی.

شاخص عمومی API

GET /api/v1بدون احراز هویت در دسترس است و اطلاعات اولیه API را ارائه می دهد. کشف ابزار، محاسبات و درخواست‌های MCP به یک کلید معتبر API نیاز دارد.

خطاها

خطاهای REST یک کد پایدار قابل خواندن توسط ماشین را در کنار یک پیام قابل خواندن توسط انسان برمی گرداند. خطاهای انتقال MCP از قالب بندی JSON-RPC استفاده می کنند و کد خطای Road User Tools را درerror.data.code.

خطای RESTjson

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again shortly."
  }
}

400invalid_requestبدنه درخواست یا یکی از فیلدهای آن نامعتبر است.

401unauthorizedکلید API گم شده، بد شکل است، باطل شده است، یا شناسایی نشده است.

403forbiddenکلید API محدوده مورد نیاز را ندارد.

404not_foundنقطه پایانی درخواستی وجود ندارد.

413payload_too_largeبدنه درخواست بیش از 16 KiB است.

415unsupported_media_typeنقطه پایانی نیاز به یک application/json درخواست کنید.

429rate_limitedبه حد درخواست رسیده است. به زودی دوباره امتحان کنید.

500internal_errorسرویس نتوانست درخواست را تکمیل کند.