What is Error Envelope?
A consistent failure shape — code, message, details, and request id — returned by every endpoint. Envelopes let clients handle errors programmatically instead of parsing unpredictable prose per route.
Related terms
OpenAPI Contract
A machine-readable spec describing every route, schema, and error so clients and tests generate from truth. BYOB treats the OpenAPI file as the API contract: code, docs, and mocks all derive from it.
Rate Limiting & 429s
The server answering 429 Too Many Requests when clients exceed quota, with Retry-After saying when to return. Limits protect shared databases and run histories from one noisy client starving everyone else.
Server Endpoint (+server.js)
The privileged layer for webhooks, secrets, and server-only logic. Anything touching keys, tokens, or private APIs lives here — never in components.
REST Resource Design
Modeling an API as nouns with stable URLs — /projects/:id/messages — instead of action endpoints. Resource design makes caching, auth scoping, and client reasoning predictable across every route.
Idempotent HTTP Verbs
GET, PUT, and DELETE produce the same result when safely retried; POST does not promise that. BYOB server routes use idempotent verbs for mutations clients may repeat after network timeouts.
Retry, Backoff & Jitter
Retrying failed calls after growing delays with random spread, so a fleet does not stampede a recovering service. Exponential backoff plus jitter turns synchronized thundering herds into gentle background noise.