نمای کلی
لُب حافظهٔ جلسه‌های شماست. جلسه را ضبط یا بارگذاری می‌کنید، لُب متن آن را پیاده می‌کند و یک لُب می‌نویسد: خلاصه، تصمیم‌ها و اقدام‌ها، که در آرشیو شما می‌ماند.
با یک توکن شخصی API، ابزارها و دستیارهای خودتان هم همین کار را می‌کنند: جلسه را می‌فرستند، منتظر می‌مانند تا آماده شود، لُب آن را می‌خوانند و از آن سؤال می‌پرسند. جلسه‌ای که با توکن می‌فرستید، همان‌قدر از دقیقه‌های موجودی شما خرج می‌کند که جلسه‌ای که در خود لُب ضبط می‌کنید.
دستیار چطور با لُب کار می‌کند
Section titled “دستیار چطور با لُب کار می‌کند”- صدای جلسه را می‌فرستد. پاسخ می‌گوید چند دقیقه خرج می‌شود. مسیر آن
POST /api/v1/recordingsاست و پاسخ202درrecordingمقدارهایid،status(QUEUED)،minutesوstatusUrlرا دارد. - هر دقیقه یک بار وضعیت را می‌پرسد:
GET /api/v1/recordings/:id/status. وضعیت به ترتیبQUEUED،TRANSCRIBING،NAMING(فقط اگر جلسه برای نام‌گذاری بایستد)،GENERATINGوREADYمی‌شود. - وقتی وضعیت به نام‌گذاری رسید، یک لینک در آن هست: دستیار آن را به شما می‌دهد و شما در لُب صداها
را نام‌گذاری می‌کنید. یا دستیار رد می‌کند و لُب از روی پیشنهادهایش نام می‌گذارد. لینک در
naming.urlاست وnaming.deadlineمی‌گوید لُب از چه زمانی بدون نام‌ها ادامه می‌دهد؛ رد شدن باPOST /api/v1/recordings/:id/namingو بدنهٔ{ "action": "skip" }است. - وقتی آماده شد، جلسه را به‌صورت JSON یا Markdown می‌خواند:
GET /api/v1/recordings/:id/bundle، و برای Markdown با?format=markdown. - در جلسه‌ها جست‌وجو می‌کند و از آن‌ها می‌پرسد:
GET /api/v1/recordings/search?q=…،POST /api/v1/recordings/:id/askوPOST /api/v1/series/:id/ask. - برای دنبال کردن چند جلسه، به‌جای پرسیدن وضعیت تک‌تک آن‌ها فید رویدادها را می‌پرسد:
GET /api/v1/events?after=<cursor>.
از این‌جا به کجا بروید
Section titled “از این‌جا به کجا بروید”- شروع سریع: فرستادن یک جلسه: توکن بسازید و یک جلسه را از صدا تا لُب پیش ببرید.
- توکن‌ها و دسترسی‌ها: «حالت توسعه‌دهنده»، هشت دسترسی، سقف روزانه و کارهایی که هیچ توکنی نمی‌تواند بکند.
- دقیقه‌ها، سقف‌ها و محدودیت‌ها: چه چیزی دقیقه خرج می‌کند، سقف درخواست‌ها و محدودیت‌های ارسال فایل.
- مرجع API: همهٔ مسیرها، فیلدها و خطاهایشان.