← Docs

API

Saykeeper-API antaa skripteille ja avustajille lukuoikeuden tapaamisiisi. Avain voi lukea ja kysyä, mutta ei luoda, muuttaa tai poistaa mitään.

API-avaimet

Luo avain sovelluksessa: Asetukset, API ja MCP, API-avaimet. Anna sille nimi.
Avain näytetään vain kerran. Saykeeper tallentaa vain sen SHA-256-tiivisteen, joten kadonnutta avainta ei voi näyttää uudelleen. Peru se ja luo uusi.
Avaimet alkavat tunnuksella ntb_live_. Pidä ne poissa URL-osoitteista, koodivarastoista ja jaetuista keskusteluista.

Valtuutus

Lähetä avain Authorization-otsakkeessa Bearer-tokenina. Jokainen pyyntö näkee vain avaimen omistajan tapaamiset.

Authorization: Bearer ntb_live_YOUR_KEY

Perusosoite

https://api.saykeeper.com/v1

Päätepisteet, jotka hyväksyvät API-avaimen

Metodi	Polku	Mitä se palauttaa
`GET`	`/meetings?limit=50`	Tapaamisesi uusimmasta alkaen (enintään 200, ?archived=true arkistoiduille).
`GET`	`/meetings/search?q=budget&limit=20`	Haku otsikoista ja litteraateista (suodattimet space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Yksi tapaaminen litteraatteineen (puhujat, ajat) ja tekoälyn tuotoksineen.
`GET`	`/meetings/shared`	Tapaamiset, jotka muut ovat jakaneet kanssasi.
`GET`	`/meetings/report`	Yksi rivi per tapaaminen puhujineen, raportteja varten.
`GET`	`/meetings/{id}/chat`	Tapaamiseen tallennetut kysymykset ja vastaukset.
`POST`	`/meetings/{id}/chat`	Kysymys yhdestä tapaamisesta. Runko {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Tapaamisesta leikatut klipit.
`GET`	`/labels`	Tunnisteesi.
`GET`	`/settings`	Asetuksesi, litteroinnin ja muistiinpanojen kieli mukaan lukien.
`POST`	`/mcp`	MCP-palvelin (JSON-RPC Streamable HTTP:n yli).

Tallennus, lataukset, tapaamisten muuttaminen tai poistaminen, asetusten muutokset sekä avainten tai webhookien hallinta vaativat kirjautuneen sovelluksen ja vastaavat avaimelle 403 session_required.

Esimerkit

Viimeisimmät tapaamiset

curl "https://api.saykeeper.com/v1/meetings?limit=5" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Haku

curl "https://api.saykeeper.com/v1/meetings/search?q=budget" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Yksi tapaaminen litteraatteineen ja muistiinpanoineen

curl "https://api.saykeeper.com/v1/meetings/MEETING_ID" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY"

Kysy tapaamisesta

curl -X POST "https://api.saykeeper.com/v1/meetings/MEETING_ID/chat" \
  -H "Authorization: Bearer ntb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"What did we agree on?"}'

Virheet

`400`	Virheellinen syöte, esimerkiksi ei-tuettu kielikoodi (`unsupported_language`).
`401`	Avain puuttuu tai on virheellinen (`missing_bearer_token`, `invalid_api_key`).
`403`	Vaatii kirjautuneen sovelluksen (`session_required`) tai ei ole sinun tapaamisesi.
`404`	Ei löytynyt.
`409`	Tapaamisella ei ole vielä litteraattia (`no_transcript`).
`429`	Käyttöraja ylitetty (`rate_limited`). Odota ja yritä uudelleen.

Käyttörajat

Mikä	Raja
Kysymykset tapaamisesta (POST /meetings/{id}/chat)	20 / minuutti
MCP ask_meeting ja ask_meetings	20 / minuutti

Webhookit

Saykeeper voi kutsua osoitettasi, kun tapaaminen on valmis. Lisää webhookit kohdassa Asetukset, API ja MCP. Jokainen lähetys allekirjoitetaan webhookin salaisuudella.