← डॉक्स

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 में जोड़ें। हर डिलीवरी वेबहुक सीक्रेट से साइन की जाती है।