אימות ומגבלות
מפתח 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" }.