תהליך התמלול

העלאה ← תמלול ← מעקב ← הורדה

התייחסו לכל פעולה כשלב עצמאי ושמרו אצלכם את upload_id ואת job_id, כדי שניסיונות חוזרים ובדיקות תמיכה יהיו צפויים.

1. 1

   העלאה

   שמרו מקום להעלאה והעבירו את הקובץ לפני פקיעת התוקף. גודל קובץ שאינו תואם יידחה.

2. 2

   תמלול

   צרו עבודה אחת לכל העלאה. אם התגובה אינה ודאית, השתמשו שוב באותו Idempotency-Key.

3. 3

   מעקב

   בצעו Polling בהשהיה הולכת וגדלה. שלחו את ה־ETag האחרון ב־If-None-Match כדי לקבל 304 כשאין שינוי.

4. 4

   הורדה

   הורידו תוצר רק לאחר שהעבודה הושלמה ובחרו SRT או טקסט רגיל לפי הצורך.

התנהגות בסביבת ייצור

• עבודות Live מחזירות בדרך כלל 202 Accepted; עבודות Test עשויות להחזיר 200 באופן מיידי.
• כבדו את X-RateLimit-Remaining ואת X-RateLimit-Reset בתגובות מוצלחות.
• שמרו את X-Request-ID במקרה של כשל, כדי שתמיכת אלף בוט תוכל לאתר את הבקשה.