Guides ยท Engineering
API Error Handling Basics
Return errors clients can use
Effective API error handling maps failures to accurate HTTP codes, returns concise messages with correlation IDs, avoids leaking secrets, and documents retry/backoff guidance for clients.
- api errors
- http codes
- error responses
- trace id
- retries
Map codes to causes
Use 4xx for client issues, 5xx for server faults; avoid 200s on errors.
Structure responses
Return machine-readable fields (code, message, details, trace_id).
Add retry guidance
Document which errors are retryable and preferred backoff patterns.
Log with correlation
Include trace IDs in responses and logs to speed support.
Keep Exploring
Guides
Intro to CAD Modeling
Learn the core CAD workflow for turning simple sketches into precise, editable 3D parts.
How it works
Air Traffic Control
Air traffic control coordinates aircraft movements to maintain safe separation.
Comparison
Hydrogen Car vs EV
Hydrogen cars make electricity from fuel onboard, while EVs store electricity directly in batteries.
Examples
Lever Simple Machine
A lever multiplies force by pivoting around a fulcrum, trading distance for mechanical advantage.