Road User Tools Aracı ve API Platformu

Genel bakış ve hızlı başlangıç

Road User Tools yol, taşıt ve yolculuk hesaplamalarını REST veya MCP üzerinden uygulamalarınıza, otomasyonlarınıza ve yapay zekâ aracılarınıza taşıyın.

REST veya MCP'yi seçin

Her iki arayüz de aynı hesaplama motorunu ve izin modelini kullanır. Her isteği kontrol ettiğiniz uygulamalar ve komut dosyaları için API anahtarıyla REST'i kullanın. Bir yapay zekâ asistanının veya aracısının mevcut araçları keşfetmesi, şemalarını anlaması ve doğru hesaplamayı kendisi seçmesi gerektiğinde MCP'yi kullanın.

REST API

Doğrudan, sürümlendirilmiş istekler

Uygulamalardan, hizmetlerden, otomasyonlardan ve komut dosyalarından yol, taşıt ve yolculuk hesaplamalarını çağırın.

https://roaduser.tools/api/v1

MCP sunucusu

Yapay zeka aracılarına yönelik araçlar

MCP uyumlu aracıların mevcut yetenekleri keşfetmesine ve uygun hesaplamayı seçmesine izin verin.

https://roaduser.tools/mcp

Kimlik doğrulama

İki oturum açma yöntemi de aynı hesaplama motoruna ulaşır. Etkileşimli yapay zekâ istemcileri MCP sunucusuna bağlanır ve erişimi tarayıcıda OAuth ile yetkilendirir. Uygulamalar, hizmetler, komut dosyaları ve manuel entegrasyonlar, Bearer belirteci olarak gönderilen bir Road User Tools API anahtarı kullanır. Anahtarlar ücretsiz oluşturulabilir ve istediğiniz zaman döndürülebilir veya iptal edilebilir.

API anahtarı oluşturun

Authorization başlığıhttp

Authorization: Bearer rut_live_...

REST hızlı başlangıç

API anahtarınızı kullanarak herhangi bir sürüme sahip REST uç noktasına bir JSON isteği gönderin. Yanıtlar tutarlı bir şekilde kullanılırok, data, veerrortüm hesaplama araçlarındaki yapı.

Bir yolculuk süresi hesaplayınshell

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 hızlı başlangıç

Sunucu URL'sini uyumlu bir yapay zekâ istemcisine ekleyin ve Road User Tools yetkilendirme sayfası açıldığında tarayıcınızda erişimi onaylayın. İstemci, oturum açma kurulumunu ve kullanılabilir araçları otomatik olarak keşfeder; kopyalanacak anahtar veya belirteç yoktur.

Sunucu URL'sihttp

https://roaduser.tools/mcp

Adım adım kurulum kılavuzu

Alternatif: API anahtarıyla manuel yapılandırma

Tarayıcı yetkilendirmesi olmayan istemciler ve programatik entegrasyonlar bunun yerine bir API anahtarı gönderebilir:

MCP istemci yapılandırmasıjson

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

REST yanıt formatı

Başarılı REST yanıtları hesaplanan sonucu döndürürdata. Doğrulama ve istek hataları, insan tarafından okunabilen bir mesajın yanı sıra makine tarafından okunabilen kararlı bir hata kodu döndürür.

JSON

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

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