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

מבנה השגיאה

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

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

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