HI
API & MCPदस्तावेज़ीकरण

Road User Tools एजेंट और API प्लेटफ़ॉर्म

गतियों को परिवर्तित करें

किलोमीटर प्रति घंटा, मील प्रति घंटा, मीटर प्रति सेकंड और नॉट के बीच कनवर्ट करें।

इंटरफ़ेस

POST
REST समापन बिंदु/api/v1/speed/convert
MCP
उपकरण का नामconvert_speed

निवेदन

अनुरोध को JSON के रूप में भेजें। MCP क्लाइंट टूल तर्कों के समान फ़ील्ड पास करते हैं।

cURLshell
curl -X POST https://roaduser.tools/api/v1/speed/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "value": 60,
  "from": "mph",
  "to": "kmh"
}'
निकाय से अनुरोध करेंjson
{
  "value": 60,
  "from": "mph",
  "to": "kmh"
}

प्रतिक्रिया

REST गणना परिणाम को मानक सफलता लिफाफे में लपेटता है। MCP संरचित टूल आउटपुट के समान गणना डेटा लौटाता है।

JSON
{
  "ok": true,
  "data": {
    "input": {
      "value": 60,
      "from": "mph",
      "to": "kmh"
    },
    "conversions": {
      "kmh": 96.56063999999999,
      "mph": 60,
      "ms": 26.8224,
      "kn": 52.13857451403887
    },
    "result": 96.56063999999999
  }
}

स्कीमा

नीचे दी गई परिभाषाएँ इनपुट को मान्य करने और आउटपुट का वर्णन करने के लिए उपयोग की जाने वाली संपूर्ण JSON स्कीमा दिखाती हैं।

इनपुट स्कीमा

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "value": {
      "type": "number",
      "description": "Speed value to convert."
    },
    "from": {
      "type": "string",
      "enum": [
        "kmh",
        "mph",
        "ms",
        "kn"
      ],
      "description": "Input speed unit."
    },
    "to": {
      "type": "string",
      "enum": [
        "kmh",
        "mph",
        "ms",
        "kn"
      ],
      "description": "Optional target unit. When omitted, all units are returned."
    }
  },
  "required": [
    "value",
    "from"
  ]
}

आउटपुट स्कीमा

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "input": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "value": {
          "type": "number"
        },
        "from": {
          "type": "string",
          "enum": [
            "kmh",
            "mph",
            "ms",
            "kn"
          ]
        },
        "to": {
          "type": "string",
          "enum": [
            "kmh",
            "mph",
            "ms",
            "kn"
          ]
        }
      },
      "required": [
        "value",
        "from"
      ]
    },
    "conversions": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "kmh": {
          "type": "number"
        },
        "mph": {
          "type": "number"
        },
        "ms": {
          "type": "number"
        },
        "kn": {
          "type": "number"
        }
      },
      "required": [
        "kmh",
        "mph",
        "ms",
        "kn"
      ]
    },
    "result": {
      "type": "number",
      "description": "Target-unit result when a target unit is supplied."
    }
  },
  "required": [
    "input",
    "conversions"
  ]
}
API और MCP दस्तावेज़