Top 10 API Design Mistakes

The tweet catalogs recurrent production API anti-patterns: no versioning plan, leaking internal identifiers, inconsistent resource naming, wrong status-code semantics, vague errors, chatty endpoints, missing idempotency, absent timeouts/retry guidance, weak auth boundaries, and poor observability/correlation.

Relevance

Directly relevant for API surface design in all backend work (Hermes services, Norviq APIs, Loci backend, ObsidianBrain sync endpoints). Good checklist for PR reviews and architecture standards.