FAIRVISOR Docs
⌘K
GitHub fairvisor.com

Get Started (API)

1) Send your first decision request

curl -i -X POST http://localhost:8080/v1/decision \
  -H 'X-Original-Method: GET' \
  -H 'X-Original-URI: /api/health'

Expect 200 when request is allowed.

2) Trigger a reject intentionally

Use a low-limit token bucket policy and send repeated requests until you get 429 with:

  • X-Fairvisor-Reason
  • Retry-After
  • RateLimit-*

3) Verify readiness and metrics

curl -sS http://localhost:8080/readyz
curl -sS http://localhost:8080/metrics | rg fairvisor_decisions_total

Next

MD