پلتفرم برنامه نویس 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سرویس نتوانست درخواست را تکمیل کند.