← 문서

API

Saykeeper API로 스크립트와 어시스턴트가 내 회의를 읽을 수 있어요. 키로는 읽고 질문할 수만 있고, 만들거나 바꾸거나 삭제할 수는 없어요.

API 키

앱에서 키를 만드세요. 설정, API 및 MCP, API 키에서 이름을 붙이면 돼요.
키는 한 번만 표시돼요. Saykeeper는 SHA-256 해시만 저장하므로 잃어버린 키는 다시 볼 수 없어요. 폐기하고 새로 만드세요.
키는 ntb_live_로 시작해요. URL, 코드 저장소, 공유 채팅에는 넣지 마세요.

인증

키를 Authorization 헤더에 Bearer 토큰으로 보내세요. 모든 요청은 키 소유자의 회의만 볼 수 있어요.

Authorization: Bearer ntb_live_YOUR_KEY

기본 URL

https://api.saykeeper.com/v1

API 키를 받는 엔드포인트

메서드	경로	반환하는 내용
`GET`	`/meetings?limit=50`	최신순 내 회의 목록(최대 200개, 보관된 회의는 ?archived=true).
`GET`	`/meetings/search?q=budget&limit=20`	제목과 전사본 검색(space_id, label_id, from, to 필터).
`GET`	`/meetings/{id}`	전사본(화자, 시간)과 AI 결과물이 포함된 회의 하나.
`GET`	`/meetings/shared`	다른 사람이 나와 공유한 회의.
`GET`	`/meetings/report`	화자 정보가 포함된, 회의당 한 행의 보고서용 데이터.
`GET`	`/meetings/{id}/chat`	회의에 저장된 질문과 답변.
`POST`	`/meetings/{id}/chat`	회의 하나에 대한 질문. 본문은 {"message":"..."}.
`GET`	`/meetings/{id}/clips`	회의에서 잘라 낸 클립.
`GET`	`/labels`	내 라벨.
`GET`	`/settings`	전사 언어와 메모 언어를 포함한 내 설정.
`POST`	`/mcp`	MCP 서버(Streamable HTTP 기반 JSON-RPC).

녹음, 업로드, 회의의 변경과 삭제, 설정 변경, 키와 웹훅 관리는 로그인된 앱이 필요하며, 키로 요청하면 403 session_required로 응답해요.

예제

최근 회의

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

검색

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

전사본과 메모가 포함된 회의 하나

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

회의에 대해 질문하기

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

오류

`400`	잘못된 입력, 예를 들어 지원하지 않는 언어 코드(`unsupported_language`).
`401`	키가 없거나 유효하지 않음(`missing_bearer_token`, `invalid_api_key`).
`403`	로그인된 앱이 필요하거나(`session_required`) 내 회의가 아님.
`404`	찾을 수 없음.
`409`	회의에 아직 전사본이 없음(`no_transcript`).
`429`	요청 한도 초과(`rate_limited`). 잠시 기다린 뒤 다시 시도하세요.

요청 한도

대상	한도
회의에 대한 질문(POST /meetings/{id}/chat)	분당 20회
MCP ask_meeting 및 ask_meetings	분당 20회

웹훅

회의가 준비되면 Saykeeper가 내 URL을 호출할 수 있어요. 설정, API 및 MCP에서 웹훅을 추가하세요. 각 전송은 웹훅 시크릿으로 서명돼요.