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?¶
- Sovi kaluston omistajan ja Ewooksin kanssa käyttöoikeudesta.
- Omistaja ottaa yhteyden käyttöön portaalissa ja luo integraatiolle nimetyn avaimen.
- Integraation kehittäjä säilyttää avaimen omalla palvelimellaan.
- Ohjelma hakee rajatun aikavälin tiedot ja käsittelee kaikki sivut.
- 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.