← Documentație

API

API-ul Saykeeper oferă scripturilor și asistenților acces de citire la întâlnirile dvs. O cheie poate citi și întreba, dar nu poate crea, modifica sau șterge nimic.

Chei API

Creați o cheie în aplicație: Setări, API și MCP, Chei API. Dați-i un nume.
Cheia este afișată o singură dată. Saykeeper stochează doar hashul ei SHA-256, deci o cheie pierdută nu mai poate fi afișată. Revocați-o și creați una nouă.
Cheile încep cu ntb_live_. Nu le puneți în URL-uri, depozite de cod sau conversații partajate.

Autorizare

Trimiteți cheia în antetul Authorization ca token Bearer. Fiecare cerere vede doar întâlnirile proprietarului cheii.

Authorization: Bearer ntb_live_YOUR_KEY

URL de bază

https://api.saykeeper.com/v1

Endpointuri care acceptă o cheie API

Metodă	Cale	Ce returnează
`GET`	`/meetings?limit=50`	Întâlnirile dvs., de la cea mai nouă (max. 200, ?archived=true pentru cele arhivate).
`GET`	`/meetings/search?q=budget&limit=20`	Căutare în titluri și transcrieri (filtre space_id, label_id, from, to).
`GET`	`/meetings/{id}`	O întâlnire cu transcriere (vorbitori, ore) și rezultate AI.
`GET`	`/meetings/shared`	Întâlnirile pe care alții le-au partajat cu dvs.
`GET`	`/meetings/report`	Un rând pentru fiecare întâlnire, cu vorbitorii, pentru rapoarte.
`GET`	`/meetings/{id}/chat`	Întrebările și răspunsurile salvate la întâlnire.
`POST`	`/meetings/{id}/chat`	O întrebare despre o întâlnire. Corpul {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Clipurile decupate din întâlnire.
`GET`	`/labels`	Etichetele dvs.
`GET`	`/settings`	Setările dvs., inclusiv limba transcrierii și a notițelor.
`POST`	`/mcp`	Server MCP (JSON-RPC prin Streamable HTTP).

Înregistrarea, încărcările, modificarea sau ștergerea întâlnirilor, modificarea setărilor și gestionarea cheilor sau a webhookurilor necesită aplicația cu cont conectat și răspund cu 403 session_required la o cheie.

Exemple

Ultimele întâlniri

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

Căutare

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

O întâlnire cu transcriere și notițe

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

Întrebare despre o întâlnire

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

Erori

`400`	Date de intrare nevalide, de exemplu un cod de limbă neacceptat (`unsupported_language`).
`401`	Cheie lipsă sau nevalidă (`missing_bearer_token`, `invalid_api_key`).
`403`	Necesită aplicația cu cont conectat (`session_required`) sau nu este întâlnirea dvs.
`404`	Nu a fost găsit.
`409`	Întâlnirea nu are încă transcriere (`no_transcript`).
`429`	Frecvență limitată (`rate_limited`). Așteptați și încercați din nou.

Limite de frecvență

Ce	Limită
Întrebări despre o întâlnire (POST /meetings/{id}/chat)	20 / minut
MCP ask_meeting și ask_meetings	20 / minut

Webhookuri

Saykeeper poate apela URL-ul dvs. când o întâlnire este gata. Adăugați webhookuri în Setări, API și MCP. Fiecare livrare este semnată cu secretul webhookului.