Oersjoch & fluchstart

Kies REST of MCP

Beide ynterfaces brûke deselde berekkeningsmotor en itselde rjochtemodel. Brûk REST mei in API-kaai foar applikaasjes en skripts dêr't jo elk fersyk sels yn beheare. Brûk MCP as in AI-assistint of agint de beskikbere ark ûntdekke, de skema's begripe en sels de juste berekkening kieze moat.

Autentikaasje

Twa oanmeldmetoaden berikke deselde berekkeningsmotor. Ynteraktive AI-kliïnten ferbine mei de MCP-tsjinner en autorisearje de tagong yn de browser mei OAuth. Applikaasjes, tsjinsten, skripts en hânmjittige yntegraasjes brûke in API-kaai fan Road User Tools dy't as Bearer-token stjoerd wurdt. Kaaien binne fergees oan te meitsjen en kinne op elk momint fernijd of ynlutsen wurde.

Authorization: Bearer rut_live_...

REST-fluchstart

Stjoer mei jo API-kaai in JSON-fersyk nei in REST-einpunt mei ferzjenûmer. Antwurden brûke in konsekwinteok, data, enerrorstruktuer foar alle berekkeningsark.

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

Foegje de tsjinner-URL ta oan in kompatibele AI-kliïnt en stean tagong ta yn jo browser as de autorisaasjeside fan Road User Tools iepene wurdt. De kliïnt ûntdekt de oanmeldopset en de beskikbere ark automatysk, sûnder kaaien of tokens om te kopiearjen.

https://roaduser.tools/mcp

Alternatyf: hânmjittige konfiguraasje mei in API-kaai

Kliïnten sûnder browserautorisaasje en programmatyske yntegraasjes kinne ynstee in API-kaai stjoere:

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

REST-antwurdopmaak

Súksesfolle REST-antwurden jouwe it berekkene resultaat werom yndata. Validaasje- en fersykmislearingen jouwe in stabile masine-lêsbere flaterkoade njonken in minsklik lêsber berjocht werom.

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

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