AJOS

Tekoälyagentit ja rajapinta

For AI agents · English version

Afirin ajopäiväkirjan voi antaa oman tekoälyn tai työkalun luettavaksi. Pääsy on aina vain luku ja koskee vain käyttäjän omia tietoja. Vaatii Ajos Plus- tai Pro-tilauksen.

1. Liitä tekoäly kirjautumalla (suositus)

Lisää tekoälysovelluksessa (Claude, ChatGPT tai mikä tahansa MCP-asiakas) uusi liitin tällä osoitteella:

https://app.afir.fi/mcp

Sovellus ohjaa Afirin kirjautumiseen (Google, Apple tai sähköposti) ja suostumussivulle. Hyväksynnän jälkeen yhteys toimii ilman avaimia. Yhteydet näkyvät ja ne voi poistaa sivulla ajos.app/oma.

2. Oma skripti tai agentti: henkilökohtainen avain

Kirjaudu sivulle ajos.app/oma ja luo avain kohdassa Tekoälyliitännät. Avain (afk_…) näytetään vain kerran. Tallenna se työkalusi salaisuuksiin, älä viestiin tai koodiin.

curl -H "Authorization: Bearer afk_..." \
     -H "User-Agent: OmaAgentti/1.0" \
     "https://app.afir.fi/api/data/summary?from=2026-01-01&to=2026-12-31&group_by=month"

Lähetä oma User-Agent

Cloudflare estää pyynnöt, joissa on ohjelmointikielen oletustunniste (esimerkiksi Python-urllib). Virhe on 403 ja viesti error code: 1010, eikä pyyntö pääse palveluun asti. Aseta aina oma tunniste:

import json, urllib.request
req = urllib.request.Request(
    "https://app.afir.fi/api/data/trips?limit=5",
    headers={"Authorization": "Bearer afk_...", "User-Agent": "OmaAgentti/1.0"},
)
print(json.load(urllib.request.urlopen(req)))

MCP-työkalut (vain luku)

Päivämäärät ovat muodossa YYYY-MM-DD. Kysymyksiä, joihin tekoäly osaa vastata: ”Paljonko ajoin työmatkoja lokakuussa?”, ”Tee kirjanpitäjälle vuoden yhteenveto kuukausittain.”

REST-rajapinta

Osoite https://app.afir.fi/api/data: /vehicles, /trips, /summary, /export.csv. Kuvaus: openapi.json. Sama kirjautuminen (OAuth) tai henkilökohtainen avain kelpaa.

Rajat ja virheet

Tietojen käyttö

Tiedot kuuluvat käyttäjälle. Käytä niitä vain siihen, mitä käyttäjä pyytää, äläkä jaa niitä eteenpäin. Käyttäjä vastaa omasta datastaan, kun antaa ulkopuoliselle sovellukselle pääsyn (tietosuojaseloste, kohta 8).

Lisätietoja