Authentication & limits
API key
Send the key on every /v1 request:
Authorization: Bearer pk_…
Keys are created (and rotated) in admin לקוחות API. The full token is shown once; only a sha256 hash is stored.
- Missing / wrong / revoked key →
401{ "error": "invalid or revoked API key" } - Rotate in admin when a key may be leaked; the old token stops working immediately
Rate limit
Fixed window per calendar minute, per key. Limit is the key's rateLimitPerMin, or the server default (API_DEFAULT_RATE_LIMIT_PER_MIN, usually 60).
Over limit → 429 { "error": "rate limit exceeded" }.