# AlefBot Developer Hub
> Public API documentation for AlefBot transcription integrations.

## Canonical machine contracts
- [OpenAPI JSON](https://alef-bot.top/api/v1/openapi.json)
- [OpenAPI YAML](https://alef-bot.top/api/v1/openapi.yaml)
- [Postman collection](https://alef-bot.top/api/v1/postman-collection.json)
- [Arazzo transcription workflow](https://alef-bot.top/api/v1/workflows/transcribe.arazzo.yaml)

## Guides
- [מתחילים](https://alef-bot.top/developers/guides/get-started.md): בדקו את החיבור ב־Test Mode לפני שמשלבים את ה־API במוצר
- [אימות ומפתחות API](https://alef-bot.top/developers/guides/authentication.md): צרו, שמרו, הגבילו והחליפו מפתחות API בצורה בטוחה
- [תהליך התמלול](https://alef-bot.top/developers/guides/transcription-workflow.md): בנו תהליך אמין להעלאה, יצירת עבודה, מעקב והורדת התוצר
- [Webhooks](https://alef-bot.top/developers/guides/webhooks.md): קבלו אירועי השלמה בצורה בטוחה ובדקו את השליחה לפני מעבר לייצור
- [שגיאות וניסיונות חוזרים](https://alef-bot.top/developers/guides/errors-and-retries.md): פרשו את מבנה השגיאה הקבוע ונסו שוב רק כאשר הפעולה בטוחה
- [יומן שינויים](https://alef-bot.top/developers/changelog.md): שינויים בחוזה ובתיעוד שמשפיעים על חיבורי API

Prefer OpenAPI for exact request and response fields. Use the guides for workflow, safety, and retry behavior.