Skip to content

Latest commit

 

History

History
26 lines (20 loc) · 702 Bytes

File metadata and controls

26 lines (20 loc) · 702 Bytes
name api-error-taxonomy
description Define consistent API error codes and responses. Use when a mid-level developer needs error standardization.

API Error Taxonomy

Purpose

Define consistent API error codes and responses.

Inputs to request

  • Current error responses and status usage.
  • Client expectations for retries and messaging.
  • Logging and observability requirements.

Workflow

  1. List common error categories and HTTP mappings.
  2. Define error payload shape and fields.
  3. Set guidelines for logging and client messaging.

Output

  • Error taxonomy table and examples.

Quality bar

  • Ensure errors are machine-parseable.
  • Align retryable vs non-retryable semantics.