Road User Tools agent- en API-platform

Overzicht en snelstart

Breng de weg-, voertuig- en reisberekeningen van Road User Tools naar je apps, automatiseringen en AI-agents via REST of MCP.

Kies REST of MCP

Beide interfaces gebruiken dezelfde rekenengine en hetzelfde rechtenmodel. Gebruik REST met een API-sleutel voor applicaties en scripts waarbij u elk verzoek beheert. Gebruik MCP wanneer een AI-assistent of agent de beschikbare tools moet ontdekken, hun schema's moet begrijpen en zelf de juiste berekening moet kiezen.

REST-API

Directe verzoeken met versiebeheer

Roep weg-, voertuig- en reisberekeningen aan vanuit applicaties, services, automatiseringen en scripts.

https://roaduser.tools/api/v1

MCP-server

Hulpmiddelen voor AI-agenten

Laat MCP-compatibele agenten de beschikbare mogelijkheden ontdekken en de juiste berekening kiezen.

https://roaduser.tools/mcp

Authenticatie

Twee aanmeldmethoden bereiken dezelfde rekenengine. Interactieve AI-clients verbinden met de MCP-server en autoriseren de toegang in de browser met OAuth. Applicaties, services, scripts en handmatige integraties gebruiken een Road User Tools API-sleutel die als Bearer-token wordt verzonden. Sleutels kunnen gratis worden aangemaakt en op elk moment worden geroteerd of ingetrokken.

Maak een API-sleutel

Authorization-kopteksthttp

Authorization: Bearer rut_live_...

REST-snelstartgids

Stuur een JSON-verzoek naar elk REST-eindpunt met versienummer met behulp van uw API-sleutel. Reacties gebruiken een consistenteok, data, enerrorstructuur in alle rekenhulpmiddelen.

Een reistijd berekenenshell

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

Voeg de server-URL toe aan een compatibele AI-client en sta toegang toe in uw browser wanneer de autorisatiepagina van Road User Tools wordt geopend. De client ontdekt de aanmeldinstellingen en de beschikbare tools automatisch, zonder sleutels of tokens om te kopiëren.

Server-URLhttp

https://roaduser.tools/mcp

Stapsgewijze installatiehandleiding

Alternatief: handmatige configuratie met een API-sleutel

Clients zonder browserautorisatie en programmatische integraties kunnen in plaats daarvan een API-sleutel sturen:

MCP-clientconfiguratiejson

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

REST-antwoordformaat

Succesvolle REST-antwoorden retourneren het berekende resultaatdata. Validatie- en verzoekfouten retourneren een stabiele, machinaal leesbare foutcode naast een voor mensen leesbaar bericht.

JSON

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

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