# שגיאות וניסיונות חוזרים

פרשו את מבנה השגיאה הקבוע ונסו שוב רק כאשר הפעולה בטוחה

Canonical: https://alef-bot.top/developers/guides/errors-and-retries

Updated: 2026-07-11

## מבנה השגיאה

כל שגיאת API ציבורית כוללת error.code, ‏error.message, ‏error.request_id ו־error.details.resolution_url. הסתמכו על code ולא על message.

> **קישורי פתרון קבועים.** פתחו את resolution_url לקבלת פתרון ממוקד. קוד שאינו מוכר מפנה חזרה למדריך זה.

## מדיניות ניסיונות חוזרים

- אל תנסו שוב שגיאות 401, ‏403 או 422 צפויות בלי לשנות את הבקשה.
- נסו שוב שגיאת 429 רק לאחר X-RateLimit-Reset ובתוספת השהיה אקראית קטנה.
- בכשלי רשת ובשגיאות 5xx זמניות, השתמשו בהשהיה מעריכית מוגבלת.
- אחרי תגובה לא ודאית מ־POST /uploads או POST /transcriptions, השתמשו שוב ב־Idempotency-Key המקורי.

## 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)