הַפנָיָה

שגיאות ומגבלות שיעור

שגיאות REST משתמשות במעטפה זו. שמור את מזהה הבקשה לתמיכה ולעולם אל תרשום את מפתח ה-API שלך:

התחל עם קוד ו-requestId

הקוד היציב מספר לתוכנית שלך מה קרה. ההודעה הניתנת לקריאה אנושית מסבירה בקשה זו. שמור requestId בעת יצירת קשר עם התמיכה.

JSON error response

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "The API key is missing, invalid, or revoked.",
    "requestId": "req_..."
  }
}

עבור 401, בדוק שהכותרת מתחילה ב-Bearer ואחריה רווח אחד ומפתח פעיל. עבור 403, בדוק את תוכנית החשבון ואת ההיקפים שנבחרו כאשר המפתח נוצר.

עבור 409 או 422, אשר שה-PUT הסתיים, התאמת Content-Type, וספירת הבתים שהועלתה שווה ל-sizeBytes. צור עבודת העלאה חדשה אם פג תוקף ה-URL הזמני.

קוד	HTTP	מַשְׁמָעוּת
BAD_REQUEST	400 / 409	HTTP 400 פירושו שגוף הבקשה אינו חוקי; HTTP 409 אומר שלא ניתן להשלים את ההעלאה במצבה הנוכחי.
UNAUTHORIZED	401	מפתח ה-API חסר, לא חוקי או בוטל.
PAID_PLAN_REQUIRED	403	לחשבון אין תוכנית בתשלום זכאית.
INSUFFICIENT_SCOPE	403	מפתח ה-API אינו כולל את ההיקף הנדרש.
NOT_FOUND	404	ההעלאה, הקובץ או השיתוף שבבעלותם לא נמצאו.
UPLOAD_NOT_READY	409	האובייקט שהועלה אינו מוכן להשלמה.
FILE_TOO_LARGE	413	הקובץ חורג ממגבלת הגודל הרלוונטית.
OBJECT_VALIDATION_FAILED	422	אימות האובייקט שהועלה נכשל.
QUOTA_EXCEEDED	429	מכסת ההעלאות נגמרה.
RATE_LIMIT_EXCEEDED	429	קצב בקשות ה-API מוצה.
SERVICE_UNAVAILABLE	503	שירות נדרש אינו זמין באופן זמני.

נסה שוב 429 רק לאחר ניסיון חוזר-אחרי. נסה שוב שגיאות 503 זמניות עם גיבוי אקספוננציאלי. אל תנסה שוב אוטומטית בקשות 400, 401 או 403 לא חוקיות.