Demo: document API error handling as a flow
Error handling is easier to review when status codes, client behavior, retry rules, and recovery actions are shown as a flowchart.
- Separate user-fixable errors from server and dependency failures.
- Mark retryable responses explicitly.
- Include observability actions for incidents.
400 invalid input -> show field error
401 unauthorized -> refresh token
409 conflict -> reload cart
503 dependency timeout -> retry with backoff