API Design Safety & Standards

•
774
•

Enforces best practices for REST API response structures and ensures data integrity for downstream exports like Excel and PDF files.

This skill provides a comprehensive safety framework for designing and modifying REST APIs, focusing on preventing common architectural pitfalls that lead to data misalignment and type ambiguity. It standardizes response field semantics, ensures consistent null handling, and strictly separates transport-level HTTP status codes from business logic. A standout feature is its rigorous validation for downstream artifacts (Excel, CSV, PDF), which prevents silent failures by mandating integrity checks before files are generated, ensuring Claude produces production-grade, reliable backend code.

주요 기능

01Standardizes 'message', 'data', and 'code' field responsibilities
02Mandates three-tier pre-validation for downstream file exports
03Enforces consistent return patterns for null objects vs. empty collections
04774 GitHub stars
05Prevents Java generic method overloading ambiguities in API responses
06Separates HTTP transport status from domain-specific business codes

사용 사례

01Implementing global exception handlers that distinguish between bugs and business logic
02Designing a standardized response wrapper for a new microservice architecture
03Refactoring legacy export functions to prevent silent data loss in third-party integrations