← Belgeler

API

Saykeeper API’si, betiklere ve asistanlara toplantılarınıza okuma erişimi verir. Bir anahtar okuyabilir ve soru sorabilir, ancak hiçbir şey oluşturamaz, değiştiremez veya silemez.

API anahtarları

Uygulamada bir anahtar oluşturun: Ayarlar, API ve MCP, API anahtarları. Ona bir ad verin.
Anahtar yalnızca bir kez gösterilir. Saykeeper yalnızca SHA-256 özetini saklar, bu yüzden kaybolan bir anahtar yeniden gösterilemez. Onu iptal edin ve yenisini oluşturun.
Anahtarlar ntb_live_ ile başlar. Onları URL’lerden, kod depolarından ve paylaşılan sohbetlerden uzak tutun.

Yetkilendirme

Anahtarı Authorization başlığında Bearer belirteci olarak gönderin. Her istek yalnızca anahtar sahibinin toplantılarını görür.

Authorization: Bearer ntb_live_YOUR_KEY

Temel URL

https://api.saykeeper.com/v1

API anahtarını kabul eden uç noktalar

Yöntem	Yol	Ne döndürür
`GET`	`/meetings?limit=50`	Toplantılarınız, en yeniden başlayarak (en fazla 200, arşivlenenler için ?archived=true).
`GET`	`/meetings/search?q=budget&limit=20`	Başlıklarda ve transkriptlerde arama (space_id, label_id, from, to filtreleri).
`GET`	`/meetings/{id}`	Transkripti (konuşmacılar, zamanlar) ve yapay zekâ çıktılarıyla bir toplantı.
`GET`	`/meetings/shared`	Başkalarının sizinle paylaştığı toplantılar.
`GET`	`/meetings/report`	Raporlar için konuşmacılarıyla birlikte her toplantı için bir satır.
`GET`	`/meetings/{id}/chat`	Toplantıyla birlikte saklanan sorular ve cevaplar.
`POST`	`/meetings/{id}/chat`	Bir toplantı hakkında soru. Gövde {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Toplantıdan kesilen klipler.
`GET`	`/labels`	Etiketleriniz.
`GET`	`/settings`	Transkript ve notların dili dahil ayarlarınız.
`POST`	`/mcp`	MCP sunucusu (Streamable HTTP üzerinden JSON-RPC).

Kayıt, yüklemeler, toplantıları değiştirme veya silme, ayar değişiklikleri ile anahtar veya webhook yönetimi oturum açılmış uygulamayı gerektirir ve bir anahtara 403 session_required yanıtı verir.

Örnekler

Son toplantılar

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

Arama

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

Transkript ve notlarıyla bir toplantı

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

Bir toplantı hakkında soru sorma

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

Hatalar

`400`	Geçersiz girdi, örneğin desteklenmeyen bir dil kodu (`unsupported_language`).
`401`	Eksik veya geçersiz anahtar (`missing_bearer_token`, `invalid_api_key`).
`403`	Oturum açılmış uygulama gerekir (`session_required`) veya toplantı size ait değil.
`404`	Bulunamadı.
`409`	Toplantının henüz transkripti yok (`no_transcript`).
`429`	Hız sınırına ulaşıldı (`rate_limited`). Bekleyin ve yeniden deneyin.

Hız limitleri

Ne	Limit
Bir toplantı hakkında sorular (POST /meetings/{id}/chat)	Dakikada 20
MCP ask_meeting ve ask_meetings	Dakikada 20

Webhook’lar

Saykeeper, bir toplantı hazır olduğunda URL’nizi çağırabilir. Webhook’ları Ayarlar, API ve MCP bölümünden ekleyin. Her teslimat webhook gizli anahtarıyla imzalanır.