منصة الوكلاء وواجهات 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لم تتمكن الخدمة من إكمال الطلب.