نمای کلی و شروع سریع

REST یا MCP را انتخاب کنید

هر دو رابط از همان موتور محاسبه و همان مدل مجوزها استفاده می‌کنند. برای برنامه‌ها و اسکریپت‌هایی که هر درخواست را خودتان کنترل می‌کنید از REST با کلید API استفاده کنید. وقتی قرار است یک دستیار یا عامل هوش مصنوعی ابزارهای موجود را کشف کند، شِماهای آن‌ها را بفهمد و خودش محاسبهٔ درست را انتخاب کند، از MCP استفاده کنید.

احراز هویت

دو روش ورود به همان موتور محاسبه می‌رسند. کلاینت‌های تعاملی هوش مصنوعی به سرور MCP متصل می‌شوند و دسترسی را با OAuth در مرورگر مجوز می‌دهند. برنامه‌ها، سرویس‌ها، اسکریپت‌ها و یکپارچه‌سازی‌های دستی از کلید Road User Tools API استفاده می‌کنند که به‌صورت توکن Bearer ارسال می‌شود. ایجاد کلیدها رایگان است و می‌توان آن‌ها را هر زمان چرخاند یا باطل کرد.

Authorization: Bearer rut_live_...

راه اندازی سریع REST

یک درخواست JSON را با استفاده از کلید API به هر نقطه پایانی REST نسخه شده ارسال کنید. پاسخ ها از یک سازگار استفاده می کنندok, data, وerrorساختار در تمام ابزارهای محاسباتی

curl -X POST https://roaduser.tools/api/v1/journey-time \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "distance": { "value": 250, "unit": "km" },
    "speed": { "value": 100, "unit": "kmh" }
  }'

راه اندازی سریع MCP

آدرس سرور را به یک کلاینت هوش مصنوعی سازگار اضافه کنید و وقتی صفحهٔ مجوز Road User Tools باز شد، دسترسی را در مرورگر خود تأیید کنید. کلاینت تنظیمات ورود و ابزارهای موجود را به‌طور خودکار کشف می‌کند، بدون هیچ کلید یا توکنی برای کپی.

https://roaduser.tools/mcp

جایگزین: پیکربندی دستی با کلید API

کلاینت‌های بدون مجوزدهی مرورگری و یکپارچه‌سازی‌های برنامه‌نویسی‌شده می‌توانند به‌جای آن یک کلید API بفرستند:

{
  "mcpServers": {
    "roaduser-tools": {
      "url": "https://roaduser.tools/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

فرمت پاسخ REST

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

{
  "ok": true,
  "data": {
    "totalHours": 2.5,
    "formatted": "2:30:00"
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Invalid journey time input."
  }
}