अवलोकन और त्वरित शुरुआत

REST या MCP चुनें

दोनों इंटरफ़ेस समान गणना इंजन और अनुमति मॉडल का उपयोग करते हैं। उन एप्लिकेशन और स्क्रिप्ट के लिए API कुंजी के साथ REST का उपयोग करें जहां आप प्रत्येक अनुरोध को नियंत्रित करते हैं। MCP का उपयोग तब करें जब किसी AI असिस्टेंट या एजेंट को उपलब्ध टूल खोजने, उनके स्कीमा समझने और सही गणना स्वयं चुनने की आवश्यकता हो।

प्रमाणीकरण

दो साइन-इन विधियाँ एक ही गणना इंजन तक पहुंचती हैं। इंटरैक्टिव AI क्लाइंट MCP सर्वर से कनेक्ट होते हैं और ब्राउज़र में OAuth के साथ पहुंच अधिकृत करते हैं। एप्लिकेशन, सेवाएं, स्क्रिप्ट और मैनुअल एकीकरण Bearer टोकन के रूप में भेजी गई Road User Tools API कुंजी का उपयोग करते हैं। कुंजियाँ निःशुल्क बनाई जा सकती हैं और किसी भी समय घुमाई या निरस्त की जा सकती हैं।

Authorization: Bearer rut_live_...

REST त्वरित प्रारंभ

अपनी API कुंजी का उपयोग करके किसी भी संस्करण वाले REST एंडपॉइंट पर JSON अनुरोध भेजें। प्रतिक्रियाएँ एक सुसंगत का उपयोग करती हैं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 त्वरित प्रारंभ

किसी संगत AI क्लाइंट में सर्वर URL जोड़ें और जब 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."
  }
}