Dev experience · 05

Rate-limit error card

Sample HTTP 429 response — JSON body, Retry-After header chip, and a link to the back-off recipe.

Production answer

Rate-limit error card is a reusable Oak Flats Muffler Men UI primitive with documented states, accessibility expectations, theme behavior, and implementation evidence.

Primary CTAReview Rate-limit error card states
Generative search brief

Rate-limit error card: Sample HTTP 429 response — JSON body, Retry-After header chip, and a link to the back-off recipe.

quotes.create — sliding-window cap
429 · Too Many RequestsPOST /v1/quotes
HeadersRetry-After: 30s
JSON
{  "error": {    "type": "rate_limit_exceeded",    "message": "Quote creation rate-limit reached for workshop wsh_oak_flats.",    "request_id": "req_01HQ8FK4ZJM7CVS3Y9VTBP2NTR",    "limit": 120,    "window_sec": 60  }}
Read the exponential back-off recipe
429 · Too Many RequestsGET /v1/parts/lookup
HeadersRetry-After: 2s
JSON
{  "error": {    "type": "burst_limit_exceeded",    "message": "Parts lookup burst limit reached — back off before retrying.",    "request_id": "req_01HQ8FK6MRPP2XNZBBQH3CAYJN",    "burst_limit": 50,    "burst_window_sec": 1  }}
Read the exponential back-off recipe
Behaviour

Tone drives the left border, status chip, and Retry-After pill. The endpoint chip is a single-line code tag — long paths truncate with an ellipsis. The entire section is labelled HTTP 429 rate-limit error for {endpoint} so a screen reader gets the verb + path together.