דלג לתוכן הראשי

אימות ומגבלות

מפתח API​

שלחו את המפתח בכל בקשת /v1:

Authorization: Bearer pk_…

מפתחות נוצרים (ומסתובבים) באדמין תחת לקוחות API. הטוקן המלא מוצג פעם אחת; נשמר רק hash של sha256.

  • מפתח חסר / שגוי / מבוטל → 401 { "error": "invalid or revoked API key" }
  • סובבו באדמין אם יש חשש לדליפה; הישן מפסיק לעבוד מיד

מגבלת קצב​

חלון קבוע לדקת שעון, לכל מפתח. המגבלה היא rateLimitPerMin של המפתח, או ברירת המחדל של השרת (API_DEFAULT_RATE_LIMIT_PER_MIN, בדרך כלל 60).

חריגה → 429 { "error": "rate limit exceeded" }.