# יומן שינויים

שינויים בחוזה ובתיעוד שמשפיעים על חיבורי API

Canonical: https://alef-bot.top/developers/changelog

Updated: 2026-08-14

## 2026-08-14

- תיעוד הורדת התוצרים מפרט כעת את SRT, ‏TXT, ‏PDF ו-DOCX, את דרכי בחירת הפורמט ואת סוגי התוכן שמוחזרים
- ה-API reference מציג כעת את גוף אירועי ה-Webhook ואת כל כותרות החתימה כ-callback של יצירת תמלול

## 2026-07-13

- Webhooks נשלחים כעת בסיום או בכישלון של תמלול, עם סוד חתימה ייחודי לחשבון וניסיונות חוזרים
- POST /webhooks/test בודק יעד וחתימה ללא יצירת תמלול; היעד חייב להיות כתובת HTTPS ציבורית בפורט 443
- מכסות הקצב נספרות כעת לפי חשבון ובנפרד לכתיבה, קריאה, הורדת תוצרים ובדיקות Webhook
- Upload slot ניתן לשימוש פעם אחת, ומדיית המקור נמחקת אוטומטית לאחר השלמת התמלול
- GET ו־POST /api/v1/keys הוסרו; ניהול המפתחות מתבצע בדשבורד, וערכי pagination לא תקינים מחזירים 422

## 2026-07-10

- פורסמו חוזי OpenAPI 3.1 מועשרים בפורמט JSON ו־YAML.
- נוספו מזהי פעולה קבועים, אימות Bearer, כותרות תגובה וסכמות שגיאה.
- נוספו קובצי Postman לבדיקה ידנית ותהליך Arazzo לבדיקת זרימת תמלול מלאה.
- נוספו כתובות תיעוד קבועות לכל שגיאה ומבנה אחיד לשגיאות אימות נתונים.

## Machine-readable sources

- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)

- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)

- [Arazzo workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)