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)
list_vehicles: ajoneuvot (merkki, malli, rekisteri, mittarilukema)list_trips: matkat uusimmasta, suodattiminafrom,to,purpose(worktaiprivate),vehicle_id,limit,offsettrip_summary: matkojen määrä, kilometrit ja korvaus ajalta;fromjatovaaditaan,group_by:none,month,vehicletaipurposeexport_trips_csv: ajopäiväkirja CSV:nä (enintään 366 päivää), sama kuin sovelluksen vienti
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
- Vain luku. Mitään ei voi lisätä, muuttaa tai poistaa.
- 120 pyyntöä minuutissa, enintään 1000 matkaa pyynnöllä, enintään 5 aktiivista avainta.
401: avain tai kirjautuminen puuttuu tai on virheellinen.403jaerror code: 1010: lisää oma User-Agent (yllä).403ilman 1010-koodia: tilaus ei oikeuta rajapintaan.- Avain lakkaa toimimasta, kun tilaus päättyy. Avaimen voi poistaa milloin tahansa sivulla ajos.app/oma.
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
- llms.txt (tiivistelmä koneille)
- Tuki · info@afir.fi