Platform Agen & API Road User Tools

Ikhtisar & mulai cepat

Hadirkan perhitungan jalan, kendaraan, dan perjalanan Road User Tools ke dalam aplikasi, otomatisasi, dan agen AI Anda melalui REST atau MCP.

Pilih REST atau MCP

Kedua antarmuka menggunakan mesin kalkulasi dan model izin yang sama. Gunakan REST dengan kunci API untuk aplikasi dan skrip tempat Anda mengontrol setiap permintaan. Gunakan MCP ketika asisten atau agen AI harus menemukan alat yang tersedia, memahami skemanya, dan memilih sendiri perhitungan yang tepat.

REST API

Permintaan langsung dan berversi

Panggil perhitungan jalan, kendaraan, dan perjalanan dari aplikasi, layanan, otomatisasi, dan skrip.

https://roaduser.tools/api/v1

Server MCP

Alat untuk agen AI

Biarkan agen yang kompatibel dengan MCP menemukan kemampuan yang tersedia dan memilih perhitungan yang sesuai.

https://roaduser.tools/mcp

Otentikasi

Dua metode masuk menjangkau mesin kalkulasi yang sama. Klien AI interaktif terhubung ke server MCP dan mengotorisasi akses di browser dengan OAuth. Aplikasi, layanan, skrip, dan integrasi manual menggunakan kunci API Road User Tools yang dikirim sebagai token Bearer. Kunci gratis dibuat dan dapat diputar atau dicabut kapan saja.

Buat kunci API

Tajuk Authorizationhttp

Authorization: Bearer rut_live_...

Mulai cepat REST

Kirim permintaan JSON ke titik akhir REST berversi apa pun menggunakan kunci API Anda. Tanggapan menggunakan yang konsistenok, data, danerrorstruktur di semua alat perhitungan.

Hitung waktu perjalananshell

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

Mulai cepat MCP

Tambahkan URL server ke klien AI yang kompatibel dan setujui akses di browser Anda saat halaman otorisasi Road User Tools terbuka. Klien menemukan penyiapan masuk dan alat yang tersedia secara otomatis, tanpa kunci atau token yang perlu disalin.

URL serverhttp

https://roaduser.tools/mcp

Panduan penyiapan langkah demi langkah

Alternatif: konfigurasi manual dengan kunci API

Klien tanpa otorisasi browser dan integrasi programatik dapat mengirim kunci API sebagai gantinya:

Konfigurasi klien MCPjson

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

Format respons REST

Respons REST yang berhasil mengembalikan hasil terhitungdata. Kegagalan validasi dan permintaan mengembalikan kode kesalahan stabil yang dapat dibaca mesin bersama dengan pesan yang dapat dibaca manusia.

JSON

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

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