Road User Tools -agentti- ja API-alusta

Yleiskatsaus ja pikaopas

Tuo Road User Tools tie-, ajoneuvo- ja matkalaskelmat sovelluksiisi, automaatioihisi ja tekoälyagentteihisi RESTin tai MCP:n kautta.

Valitse REST tai MCP

Molemmat rajapinnat käyttävät samaa laskentamoottoria ja oikeusmallia. Käytä RESTiä API-avaimella sovelluksissa ja skripteissä, joissa hallitset jokaista pyyntöä. Käytä MCP:tä, kun tekoälyavustajan tai agentin pitää löytää saatavilla olevat työkalut, ymmärtää niiden skeemat ja valita oikea laskenta itse.

REST API

Suorat, versioidut pyynnöt

Soita tie-, ajoneuvo- ja matkalaskelmia sovelluksista, palveluista, automaatioista ja skripteistä.

https://roaduser.tools/api/v1

MCP-palvelin

Työkalut tekoälyagenteille

Anna MCP-yhteensopivien agenttien löytää käytettävissä olevat ominaisuudet ja valita sopiva laskelma.

https://roaduser.tools/mcp

Todennus

Kaksi kirjautumistapaa käyttävät samaa laskentamoottoria. Vuorovaikutteiset tekoälyasiakkaat yhdistävät MCP-palvelimeen ja valtuuttavat pääsyn selaimessa OAuthilla. Sovellukset, palvelut, skriptit ja manuaaliset integraatiot käyttävät Road User Tools API-avainta Bearer-tunnisteena. Avaimet ovat ilmaisia luoda, ja ne voi vaihtaa tai perua milloin tahansa.

Luo API-avain

Authorization otsikkohttp

Authorization: Bearer rut_live_...

REST pikakäynnistys

Lähetä JSON-pyyntö mihin tahansa versioituun REST-päätepisteeseen käyttämällä API-avainta. Vastauksissa käytetään johdonmukaisuuttaok, data, jaerrorrakenne kaikissa laskentatyökaluissa.

Laske matka-aikashell

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 pikakäynnistys

Lisää palvelimen URL yhteensopivaan tekoälyasiakkaaseen ja hyväksy pääsy selaimessasi, kun Road User Toolsin valtuutussivu avautuu. Asiakas löytää kirjautumisasetukset ja saatavilla olevat työkalut automaattisesti, eikä avaimia tai tunnisteita tarvitse kopioida.

Palvelimen URLhttp

https://roaduser.tools/mcp

Vaiheittainen käyttöönotto-opas

Vaihtoehto: manuaalinen määritys API-avaimella

Asiakkaat ilman selainvaltuutusta sekä ohjelmalliset integraatiot voivat lähettää sen sijaan API-avaimen:

MCP-asiakaskokoonpanojson

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

REST vastausmuoto

Onnistuneet REST-vastaukset palauttavat lasketun tuloksendata. Vahvistus- ja pyyntövirheet palauttavat vakaan koneellisesti luettavan virhekoodin sekä ihmisen luettavissa olevan viestin.

JSON

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

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