← Dokumentáció

API

A Saykeeper API olvasási hozzáférést ad szkripteknek és asszisztenseknek a megbeszéléseihez. A kulcs olvasni és kérdezni tud, létrehozni, módosítani vagy törölni semmit nem.

API-kulcsok

Hozzon létre kulcsot az alkalmazásban: Beállítások, API és MCP, API-kulcsok. Adjon neki nevet.
A kulcs csak egyszer jelenik meg. A Saykeeper csak az SHA-256 hashét tárolja, ezért az elveszett kulcsot nem lehet újra megmutatni. Vonja vissza, és hozzon létre újat.
A kulcsok ntb_live_ előtaggal kezdődnek. Ne tegye őket URL-ekbe, kódtárakba és megosztott csevegésekbe.

Hitelesítés

Küldje el a kulcsot az Authorization fejlécben Bearer-tokenként. Minden kérés csak a kulcs tulajdonosának megbeszéléseit látja.

Authorization: Bearer ntb_live_YOUR_KEY

Alap-URL

https://api.saykeeper.com/v1

API-kulcsot elfogadó végpontok

Metódus	Útvonal	Mit ad vissza
`GET`	`/meetings?limit=50`	A megbeszélései a legújabbtól kezdve (legfeljebb 200, ?archived=true az archiváltakhoz).
`GET`	`/meetings/search?q=budget&limit=20`	Keresés a címekben és az átiratokban (szűrők: space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Egy megbeszélés átirattal (beszélők, időpontok) és MI-kimenetekkel.
`GET`	`/meetings/shared`	Megbeszélések, amelyeket mások megosztottak Önnel.
`GET`	`/meetings/report`	Soronként egy megbeszélés a beszélőkkel, jelentésekhez.
`GET`	`/meetings/{id}/chat`	A megbeszéléshez mentett kérdések és válaszok.
`POST`	`/meetings/{id}/chat`	Kérdés egy megbeszélésről. A törzs: {"message":"..."}.
`GET`	`/meetings/{id}/clips`	A megbeszélésből kivágott klipek.
`GET`	`/labels`	Az Ön címkéi.
`GET`	`/settings`	Az Ön beállításai, beleértve az átirat és a jegyzetek nyelvét.
`POST`	`/mcp`	MCP-szerver (JSON-RPC Streamable HTTP-n).

A rögzítés, feltöltések, a megbeszélések módosítása vagy törlése, a beállítások módosítása, valamint a kulcsok és webhookok kezelése bejelentkezett alkalmazást igényel, és a kulcsra 403 session_required választ adnak.

Példák

Legutóbbi megbeszélések

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

Keresés

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

Egy megbeszélés átirattal és jegyzetekkel

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

Kérdés egy megbeszélésről

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?"}'

Hibák

`400`	Érvénytelen bemenet, például nem támogatott nyelvkód (`unsupported_language`).
`401`	Hiányzó vagy érvénytelen kulcs (`missing_bearer_token`, `invalid_api_key`).
`403`	Bejelentkezett alkalmazás kell hozzá (`session_required`), vagy nem az Ön megbeszélése.
`404`	Nem található.
`409`	A megbeszélésnek még nincs átirata (`no_transcript`).
`429`	Sebességkorlát (`rate_limited`). Várjon, és próbálja újra.

Sebességkorlátok

Mire	Korlát
Kérdések egy megbeszélésről (POST /meetings/{id}/chat)	20 / perc
MCP ask_meeting és ask_meetings	20 / perc

Webhookok

A Saykeeper meghívhatja az Ön URL-jét, amikor egy megbeszélés elkészül. A webhookokat a Beállítások, API és MCP menüben adhatja hozzá. Minden kézbesítést a webhook titkos kulcsával írunk alá.