eewookskehittäjille
Version 0.2 dokumentaatioAPI 0.2.0 on käytössä ja varmennettu. Tarkista saatavuus ennen integraation käyttöönottoa.

Ewooks MCP API · Kehittäjäohje

Ewooks-integraatio kehittäjälle

Ewooksin MCP-rajapinnalla oma ohjelmasi voi lukea yrityksen kaluston ajoja ja työaikakirjauksia. Käyttö ei vaadi tekoälyä tai avointa chat-istuntoa.

Mistä aloitetaan?

  1. Sovi kaluston omistajan ja Ewooksin kanssa käyttöoikeudesta.
  2. Omistaja ottaa yhteyden käyttöön portaalissa ja luo integraatiolle nimetyn avaimen.
  3. Integraation kehittäjä säilyttää avaimen omalla palvelimellaan.
  4. Ohjelma hakee rajatun aikavälin tiedot ja käsittelee kaikki sivut.
  5. Vastaanottava ohjelma tekee omat kohdistukset, tarkastukset, hyväksynnät ja jatkosiirrot.
Ympäristö MCP-osoite
Tuotanto https://mcp.ewooks.fi/mcp

MCP 0.2.0 on asennettu ja varmennettu tässä osoitteessa. Tarkista julkaisutilanne ja yhteyttä avatessa initialize-vastauksen versio. Sovi Ewooksin kanssa erillisestä testikalustosta ennen oikeiden asiakastietojen lukemista.

Mitä tietoa saa?

Rajapinnassa on neljä lukutyökalua: ajojen listaus ja yhteenveto sekä työaikakirjausten listaus ja yhteenveto. Version 0.2 ajohauissa palautetaan vain työajoiksi luokitellut ajot. Yksityisajot ja tuntemattomat luokat jäävät pois.

Yritys/fleet määräytyy tunnuksesta. Sitä ei voi vaihtaa hakuehdolla. Ajolla on tunniste, kilometrit, ajankohdat ja mahdollinen työ-/asiakasviite. Kuljettajan ja auton rekisteritunniste palautuu vain yksiselitteisen saman fleetin kytkennän perusteella; muuten arvo on null.

Mitä integraation pitää itse ratkaista?

Ajettu matka, työntekijälle korvattavat kilometrit ja asiakkaalta laskutettavat kilometrit voivat poiketa toisistaan. Tallennettu ajo ei tarkoita hyväksyttyä palkka- tai laskutustapahtumaa.

Työviite on vapaa teksti. Vastaanottajan pitää tarkistaa työmääräyskohdistus, työntekijätunnisteet, hyväksyntä ja saman ajon kaksoissiirron esto. Tässä versiossa ei ole jatkuvaa muutos-/poistosyötettä tai webhookeja. Ensimmäiseen toteutukseen sopii erikseen hyväksytty aineistoerä ja sovittu jälkikorjausten käsittely.

Koko tekninen ohje on saatavilla suomeksi: ensimmäinen kutsu, työkalut, kentät, sivutus ja ajettavat Python-, Node.js- ja PHP-esimerkit.

Työkalut

Työkalu Käyttötarkoitus
list_drives Yksittäiset työajoiksi luokitellut ajot, matkat ja mahdolliset työviitteet
summarize_drives Ajojen määrä ja kirjattu matka yhteensä sekä kuljettajittain
list_work_sessions Työpäiväkirjan merkinnät ja niihin tallennetut tunnit
summarize_work_sessions Työmerkintöjen määrä ja tunnit yhteensä sekä kuljettajittain

Yhteys käyttää HTTP POST -pyyntöjä ja JSON-RPC 2.0 -viestejä. Tässä versiossa ei ole REST-reittejä kuten /v1/drives tai kirjoitustoimintoja. Tietoturvakäytännöt kuvataan omassa ohjeessaan.

Ewooksin kehittäjäohjeet · Päivitetty 21.11.2026 · Esimerkkitiedot ovat synteettisiä