API Design Review Framework

API design reviews fail when they evaluate whether the API works without evaluating whether it's consistent. An API where some endpoints return `{ data: result }` and others return `result` directly, where some errors return `{ message: "..." }` and others return `{ error: { code: "...", message: "..." } }`, forces consumers to write special-case handling for every endpoint. Inconsistency multiplies consumer effort and produces integration bugs that are hard to diagnose.

The API Design Review Framework checks HTTP semantics, response consistency, security controls, and the specific conventions that determine whether a consumer can build a reliable integration.