← Docs

API

API Saykeeper memberi skrip dan asisten akses baca ke rapat Anda. Sebuah kunci dapat membaca dan bertanya, tetapi tidak dapat membuat, mengubah, atau menghapus apa pun.

Kunci API

Buat kunci di aplikasi: Pengaturan, API dan MCP, Kunci API. Beri nama.
Kunci ditampilkan sekali saja. Saykeeper hanya menyimpan hash SHA-256-nya, sehingga kunci yang hilang tidak dapat ditampilkan lagi. Cabut kunci itu dan buat yang baru.
Kunci diawali dengan ntb_live_. Jangan letakkan di URL, repositori kode, atau obrolan bersama.

Otorisasi

Kirim kunci di header Authorization sebagai token Bearer. Setiap permintaan hanya melihat rapat milik pemilik kunci.

Authorization: Bearer ntb_live_YOUR_KEY

URL dasar

https://api.saykeeper.com/v1

Endpoint yang menerima kunci API

Metode	Path	Yang dikembalikan
`GET`	`/meetings?limit=50`	Rapat Anda dari yang terbaru (maks 200, ?archived=true untuk yang diarsipkan).
`GET`	`/meetings/search?q=budget&limit=20`	Cari di judul dan transkrip (filter space_id, label_id, from, to).
`GET`	`/meetings/{id}`	Satu rapat dengan transkrip (pembicara, waktu) dan hasil AI.
`GET`	`/meetings/shared`	Rapat yang dibagikan orang lain kepada Anda.
`GET`	`/meetings/report`	Satu baris per rapat dengan pembicara, untuk laporan.
`GET`	`/meetings/{id}/chat`	Pertanyaan dan jawaban yang tersimpan pada rapat.
`POST`	`/meetings/{id}/chat`	Pertanyaan tentang satu rapat. Body {"message":"..."}.
`GET`	`/meetings/{id}/clips`	Klip yang dipotong dari rapat.
`GET`	`/labels`	Label Anda.
`GET`	`/settings`	Pengaturan Anda, termasuk bahasa transkrip dan catatan.
`POST`	`/mcp`	Server MCP (JSON-RPC melalui Streamable HTTP).

Perekaman, unggahan, mengubah atau menghapus rapat, perubahan pengaturan, serta pengelolaan kunci atau webhook memerlukan aplikasi yang sudah masuk dan dijawab dengan 403 session_required jika memakai kunci.

Contoh

Rapat terbaru

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

Cari

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

Satu rapat dengan transkrip dan catatan

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

Bertanya tentang rapat

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

Kesalahan

`400`	Input tidak valid, misalnya kode bahasa yang tidak didukung (`unsupported_language`).
`401`	Kunci tidak ada atau tidak valid (`missing_bearer_token`, `invalid_api_key`).
`403`	Memerlukan aplikasi yang sudah masuk (`session_required`) atau bukan rapat Anda.
`404`	Tidak ditemukan.
`409`	Rapat belum memiliki transkrip (`no_transcript`).
`429`	Dibatasi laju (`rate_limited`). Tunggu dan coba lagi.

Batas laju

Apa	Batas
Pertanyaan tentang satu rapat (POST /meetings/{id}/chat)	20 / menit
MCP ask_meeting dan ask_meetings	20 / menit

Webhook

Saykeeper dapat memanggil URL Anda ketika rapat sudah siap. Tambahkan webhook di Pengaturan, API dan MCP. Setiap pengiriman ditandatangani dengan rahasia webhook.