منصة المطورين Mariner GPS Tools

الحدود والتحقق

تخضع استدعاءات API وMCP العامة لحدود المعدل. يجري التحقق من المدخلات قبل الحساب، بما في ذلك وحدات السرعة المدعومة والقيم العددية المحدودة ونطاقات خط العرض أو خط الطول.

حدود الطلب

تقتصر هيئات طلب JSON على16 KiB. يتم التحقق من صحة المدخلات قبل الحساب، بما في ذلك الوحدات المدعومة والقيم الرقمية المحدودة والحقول غير المتوقعة ونطاقات خطوط الطول والعرض الصالحة.

مؤشر API العام

GET /api/v1متاح بدون مصادقة ويوفر معلومات API الأساسية. يتطلب اكتشاف الأداة والحسابات وطلبات MCP مفتاح API صالحًا.

أخطاء

تُرجع أخطاء REST رمزًا مستقرًا يمكن قراءته بواسطة الآلة إلى جانب رسالة يمكن قراءتها بواسطة الإنسان. تستخدم أخطاء النقل MCP تنسيق JSON-RPC وتتضمن رمز الخطأ Mariner GPS 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لم تتمكن الخدمة من إكمال الطلب.