Skip to main content

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" }.