AR
API & MCPالتوثيق

منصة الوكلاء وواجهات API Road User Tools

تحويل الاقتصاد في استهلاك الوقود

التحويل بين ميلا في الغالون في المملكة المتحدة، ميلا في الغالون في الولايات المتحدة، لتر لكل 100 الكيلومترات والكيلومترات لكل لتر.

واجهات

POST
نقطة النهاية REST/api/v1/fuel-economy/convert
MCP
اسم الأداةconvert_fuel_economy

طلب

أرسل الطلب كـ JSON. يقوم عملاء MCP بتمرير نفس الحقول كوسيطات الأداة.

cURLshell
curl -X POST https://roaduser.tools/api/v1/fuel-economy/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "value": 40,
  "from": "mpg_uk",
  "to": "l_per_100km"
}'
هيئة الطلبjson
{
  "value": 40,
  "from": "mpg_uk",
  "to": "l_per_100km"
}

الاستجابة

يقوم REST بتغليف نتيجة الحساب في مظروف النجاح القياسي. تقوم MCP بإرجاع نفس بيانات الحساب مثل مخرجات الأداة المنظمة.

JSON
{
  "ok": true,
  "data": {
    "input": {
      "value": 40,
      "from": "mpg_uk",
      "to": "l_per_100km"
    },
    "conversions": {
      "mpg_uk": 40,
      "mpg_us": 33.30696738515955,
      "l_per_100km": 7.062023408295555,
      "km_per_l": 14.160247597385885
    },
    "result": 7.062023408295555
  }
}

المخططات

توضح التعريفات أدناه مخطط JSON الكامل المستخدم للتحقق من صحة المدخلات ووصف المخرجات.

مخطط الإدخال

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "value": {
      "type": "number",
      "description": "Fuel economy value to convert. Must be finite and greater than zero."
    },
    "from": {
      "type": "string",
      "enum": [
        "mpg_uk",
        "mpg_us",
        "l_per_100km",
        "km_per_l"
      ],
      "description": "Input fuel economy unit."
    },
    "to": {
      "type": "string",
      "enum": [
        "mpg_uk",
        "mpg_us",
        "l_per_100km",
        "km_per_l"
      ],
      "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": [
            "mpg_uk",
            "mpg_us",
            "l_per_100km",
            "km_per_l"
          ]
        },
        "to": {
          "type": "string",
          "enum": [
            "mpg_uk",
            "mpg_us",
            "l_per_100km",
            "km_per_l"
          ]
        }
      },
      "required": [
        "value",
        "from"
      ]
    },
    "conversions": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "mpg_uk": {
          "type": "number"
        },
        "mpg_us": {
          "type": "number"
        },
        "l_per_100km": {
          "type": "number"
        },
        "km_per_l": {
          "type": "number"
        }
      },
      "required": [
        "mpg_uk",
        "mpg_us",
        "l_per_100km",
        "km_per_l"
      ]
    },
    "result": {
      "type": "number",
      "description": "Target-unit result when a target unit is supplied."
    }
  },
  "required": [
    "input",
    "conversions"
  ]
}
وثائق API وMCP