Road User Tools Aracı ve API Platformu

Yakıt ekonomisini dönüştür

Birleşik Krallık MPG, ABD MPG, 100 kilometre başına litre ve litre başına kilometre arasında dönüşüm yapın.

Arayüzler

POST

REST uç noktası/api/v1/fuel-economy/convert

MCP

Araç adıconvert_fuel_economy

Talep

İsteği JSON olarak gönderin. MCP istemcileri, araç bağımsız değişkenleriyle aynı alanları iletir.

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"
}'

Talep gövdesijson

{
  "value": 40,
  "from": "mpg_uk",
  "to": "l_per_100km"
}

Yanıt

REST hesaplama sonucunu standart başarı zarfına sarar. MCP, yapılandırılmış araç çıktısıyla aynı hesaplama verilerini döndürür.

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
  }
}

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

Şemalar

Aşağıdaki tanımlar, girişleri doğrulamak ve çıkışları tanımlamak için kullanılan JSON Şemasının tamamını gösterir.

Girdi şeması

{
  "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"
  ]
}

Çıktı şeması

{
  "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"
  ]
}