Hivemill

Rate-limit the public API

Demo snapshotAll normalNeeds you 7Cursor usage · 42.2 h · Pro · ok

Active Claude · P1 · g-006-a · updated 11-18 08:00

Intent

Protect the public API from bursts of traffic from a single key.

Teams 1

  • g-006-a lead-g-006-a ActiveRate limiter, headers, metrics and docs
    • Runningcoder-t-0109 coder ClaudeT-0109
    • Runningcoder-t-0113 coder ClaudeT-0113
    • Runninglead-g-006-a lead Claude
    • Runningqa-t-0112 qa ClaudeT-0112
    • Runningreviewer-t-0114 reviewer ClaudeT-0114
25/33 tasks

Cost and time

Tokens
24,928,400
Estimated cost, tasks
$13.24
Estimated cost, goal overhead
$3.51
Estimated cost, total
$16.75
Rework share
0%
Merged PRs
24
Median wall time per merged PR
5h 00m

Estimated at list prices as of 2026-10-25 (API-equivalent, not a bill).

Success criteria 0/4

  • To doOpenSC1Each API key has a request limit.
  • To doOpenSC2A limited call gets a 429 with a Retry-After header.
  • To doOpenSC3Limits are visible as metrics.
  • To doOpenSC4The settings are documented.

Tasks 33

statusIDTaskAssigneePRTries
In review 1
In reviewT-0097Tune the burst allowance coder-t-0097PR2
In progress 4
In progressT-0109Add per-route limit overrides coder-t-01091
In progressT-0112Verify the limiter under load qa-t-01121
In progressT-0113Expose limiter metrics per route coder-t-01131
In progressT-0114Review the burst allowance PR reviewer-t-01141
To do 3
To doT-0105Decide merge for the burst allowance PR judge
To doT-0106Add limit headers to error pages coder
To doT-0108Document the limiter settings coder
Done25
statusIDTaskAssigneePRTries
DoneT-0032Specify rate-limit the public API pm-t-00321
DoneT-0035Store counters in a token bucket coder-t-0035PR2
DoneT-0036Add a per-key request limiter coder-t-0036PR1
DoneT-0037Return 429 with a JSON error body coder-t-0037PR1
DoneT-0039Send the Retry-After header coder-t-0039PR2
DoneT-0047Add limit headers to every response coder-t-0047PR1
DoneT-0053Read the limits from a config file coder-t-0053PR1
DoneT-0054Let internal callers skip the limit coder-t-0054PR1
DoneT-0062Count limited calls in a metric coder-t-0062PR1
DoneT-0064Use a sliding window for the hourly limit coder-t-0064PR1
DoneT-0068Fall back to in-memory counters coder-t-0068PR1
DoneT-0069Add an admin endpoint to reset a key coder-t-0069PR1
DoneT-0072Log the first limited call per key coder-t-0072PR2
DoneT-0075Validate limit settings at start-up coder-t-0075PR2
DoneT-0079Add a limits page to the developer portal coder-t-0079PR1
DoneT-0083Warn owners at 80 percent of the limit coder-t-0083PR1
DoneT-0086Show remaining calls in the portal coder-t-0086PR1
DoneT-0089Return the same limit for a rotated key coder-t-0089PR1
DoneT-0093Add load tests for the limiter coder-t-0093PR2
DoneT-0095Clean up expired counters coder-t-0095PR1
DoneT-0100Document the limit headers coder-t-0100PR1
DoneT-0101Store counters in a token bucket (follow-up) coder-t-0101PR2
DoneT-0102Add a per-key request limiter (follow-up) coder-t-0102PR1
DoneT-0115Return 429 with a JSON error body (follow-up) coder-t-0115PR2
DoneT-0118Send the Retry-After header (follow-up) coder-t-0118PR1