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

Python-, Node.js- ja PHP-esimerkit

Valitse ajettava taustaohjelma integraatiosi ohjelmointikielen mukaan. Kaikki kolme lukevat kokonaisen rajatun tilannekuvan, hyväksyvät samat komentorivivalitsimet ja noudattavat samoja tunnistautumisen ja turvallisuuden sääntöjä. Chat-istuntoa tai tekoälyä ei tarvita.

Kieli Ajoympäristö Lataus
Python Python 3.10+, vain vakiokirjasto ewooks_mcp_client.py
Node.js Node.js 22+, vain sisäänrakennetut moduulit ewooks_mcp_client.mjs
PHP PHP 8.1+ ja ext-curl, ei Composer-paketteja ewooks_mcp_client.php.txt

Lataa työkalumäärittelyt.

PHP jaetaan tarkoituksella tekstimuotoisena lähdekoodina, ei palvelimella suoritettavana verkkoreittinä. Voit ajaa ladatun .php.txt-tiedoston suoraan PHP:n komentorivitulkilla tai nimetä sen .php-tiedostoksi omalla suojatulla taustapalvelimellasi. Myös Node.js-esimerkki kuuluu taustapalveluun, ei selaimeen.

Python

Edellytykset ovat Python 3.10 tai uudempi ja ympäristö, jossa MCP 0.2 on käytössä. Aseta avain salaisuuksien hallinnan kautta. Älä lisää sitä komentoriviargumentiksi tai ladattuun tiedostoon.

export EWOOKS_MCP_URL='https://mcp.ewooks.fi/mcp'
# EWOOKS_MCP_KEY tulee palvelimesi salaisuuksien hallinnasta.
python ewooks_mcp_client.py --from 2026-11-20 --to 2026-11-20

Ohjelma tulostaa oletuksena vain tietueiden määrän. Työaikakirjausten haku:

python ewooks_mcp_client.py --resource work-sessions \
  --from 2026-11-20 --to 2026-11-20

Voit erikseen pyytää valtuutetut lähderivit uuteen paikalliseen NDJSON-tiedostoon:

python ewooks_mcp_client.py --from 2026-11-20 --to 2026-11-20 \
  --output tarkastettava-aineisto.ndjson

Tiedosto sisältää henkilö- ja liiketoimintatietoa. Suojaa se normaalien käyttöoikeus- ja säilytyskäytäntöjesi mukaan. Epäonnistunut haku ei julkaise osittaista tiedostoa, eikä olemassa olevaa tulostiedostoa korvata.

Node.js

Ympäristömuuttujat ovat samat kuin Pythonissa: EWOOKS_MCP_URL valitsee kiinteän tuotanto-/demo-osoitteen ja EWOOKS_MCP_KEY tulee salaisuuksien hallinnasta.

node ewooks_mcp_client.mjs --from 2026-11-20 --to 2026-11-20
node ewooks_mcp_client.mjs --resource work-sessions \
  --from 2026-11-20 --to 2026-11-20
node ewooks_mcp_client.mjs --from 2026-11-20 --to 2026-11-20 \
  --output tarkastettava-aineisto.ndjson

Lukijan käyttö omassa palvelimen ES-moduulissa:

import { EwooksClient } from './ewooks_mcp_client.mjs';

const client = new EwooksClient(process.env.EWOOKS_MCP_URL, process.env.EWOOKS_MCP_KEY);
await client.initialize();
let count = 0;
for await (const row of client.records('drives', '2026-11-20', '2026-11-20')) {
  // Tarkista kohdistukset ja hyväksyntä ennen jatkokäsittelyä.
  count++;
}
console.log(`Luettiin ${count} lähdetietuetta.`);

JavaScript ei esitä kaikkia suuria kokonaislukuja tarkasti. Esimerkki hylkää epätarkat numeeriset rivitunnisteet pyöristämisen sijaan. Desimaalimerkkijonoina palautuvat tunnisteet säilyvät täsmällisinä.

PHP

Ota ext-curl käyttöön ja pidä TLS-varmenteen sekä palvelinnimen tarkistus käytössä. Esimerkki ei tarvitse CakePHP:tä tai Composer-paketteja. Aja se taustapalvelimen komentorivillä:

php ewooks_mcp_client.php.txt --from 2026-11-20 --to 2026-11-20
php ewooks_mcp_client.php.txt --resource work-sessions \
  --from 2026-11-20 --to 2026-11-20
php ewooks_mcp_client.php.txt --from 2026-11-20 --to 2026-11-20 \
  --output tarkastettava-aineisto.ndjson

Lukijan käyttö omassa taustapalvelun PHP-koodissa:

<?php
require __DIR__ . '/ewooks_mcp_client.php.txt';

$client = new EwooksMcpExampleClient(getenv('EWOOKS_MCP_URL'), getenv('EWOOKS_MCP_KEY'));
$client->initialize();
$count = 0;
foreach ($client->records('drives', '2026-11-20', '2026-11-20') as $row) {
    // Tarkista kohdistukset ja hyväksyntä ennen jatkokäsittelyä.
    $count++;
}
echo "Luettiin {$count} lähdetietuetta.\n";

Kaikissa komentoriviohjelmissa ovat valitsimet --from, --to, --resource, --driver, --output ja --help. Oletustuloste on vain tietueiden määrä. Erikseen pyydetty NDJSON-tiedosto julkaistaan vasta kokonaan onnistuneen haun jälkeen, eikä olemassa olevaa tiedostoa korvata. Rajaa myös tulostiedostojen ja niiden hakemistojen käyttöoikeudet.

Mitä esimerkit tarkistavat?

  • Vain erikseen sallitut, kiinteät tuotannon ja demon HTTPS-päätepisteet; TLS-varmennus ja uudelleenohjausten esto.
  • Alustusvastauksen, neuvotellun protokollaversion ja palvelinversion ennen tilannekuvahakuja.
  • HTTP-virheet, JSON-RPC-virheet ja työkalutason virheet erikseen.
  • Tilannekuvan kaikki sivut, myös tyhjän sivun, jolla on jatkokursori.
  • Päällekkäiset lähdetunnisteet, odottamattoman fleet-vaihdoksen ja toistuvat kursorit.
  • Vastauksen enimmäiskoon ja sivujen enimmäismäärän.

Samat ladattavat ohjelmat palvelevat molempia kieliä. Niiden komentorivivalitsimet ja käyttö-/virhetekstit ovat englanniksi. Esimerkiksi Read 5 records from one bounded snapshot kertoo viiden tietueen hausta, ja This example requires a verified Ewooks MCP 0.2 deployment tarkoittaa, että kohdeympäristöstä on ensin varmistettava versio 0.2.

Esimerkit hylkäävät vanhemman palvelinversion; tarkista julkaisutilanne ennen käyttöä. Ne eivät kirjoita taloushallintoon, hyväksy kirjauksia, laske palkkoja tai tarjoa muutossyötettä. Käytä niitä integraation lähtökohtina ja sovita hälytykset, rajatut uudelleenyritykset, ajastus, säilytys ja kohdejärjestelmän kaksoiskäsittelyn esto omaan ympäristöösi.

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