API-dokumentaatio

Käytä Agent Leap API:a hallitaksesi agentteja ja tehtäviä omista sovelluksistasi. Tämä on yksinkertainen REST API JSON-vastauksilla.

Huom: API-pääsy on saatavilla Yritys-tasolla (149 €/kk). Päivitä hallintapaneelista saadaksesi API-avaimesi.

Tunnistautuminen

Kaikki API-pyynnöt vaativat API-avaimen Authorization-otsikossa. Löydät API-avaimesi hallintapaneelista kohdasta Asetukset > API.

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.agentleap.fi/v1/agents

Perus-URL

https://api.agentleap.fi/v1

Rajapinnat

POST/v1/agents

Luo uusi tekoälyagentti. Anna nimi ja kuvaus siitä mitä agentin tulisi tehdä.

curl -X POST https://api.agentleap.fi/v1/agents \
  -H "Authorization: Bearer API_AVAIMESI" \
  -H "Content-Type: application/json" \
  -d {
    "name": "Sähköpostiyhteenveto",
    "description": "Tiivistä saapuvat sähköpostit joka aamu klo 9:00"
  }

GET/v1/agents

Listaa kaikki agenttisi. Palauttaa taulukon agenttiobjekteja niiden nykyisen tilan kanssa.

curl https://api.agentleap.fi/v1/agents \
  -H "Authorization: Bearer API_AVAIMESI"

POST/v1/tasks

Käynnistä tehtävä manuaalisesti tietylle agentille. Hyödyllinen kertaluonteisissa ajoissa tai testauksessa.

curl -X POST https://api.agentleap.fi/v1/tasks \
  -H "Authorization: Bearer API_AVAIMESI" \
  -H "Content-Type: application/json" \
  -d {
    "agent_id": "ag_abc123",
    "input": "Tiivistä tämän päivän sähköpostit"
  }

GET/v1/tasks

Listaa viimeaikaiset tehtävät kaikista agenteista. Suodata agent_id:n, tilan tai aikavälin mukaan.

curl "https://api.agentleap.fi/v1/tasks?agent_id=ag_abc123&limit=10" \
  -H "Authorization: Bearer API_AVAIMESI"

Nopeusrajat

API-pyynnöt on rajoitettu 100 pyyntöön minuutissa API-avainta kohti. Jos ylität tämän rajan, saat 429 Too Many Requests -vastauksen. Vastausotsikot sisältävät X-RateLimit-Remaining ja X-RateLimit-Reset auttaen pyyntötahtisi hallinnassa.