Безопасное проектирование REST API

engineering

api-design-safety is a Claude Code skill that prevents REST API design defects causing silent failures in downstream systems. It addresses five concrete pitfalls: Java generic method overload ambiguity where a String argument resolves to the wrong success() overload and lands in message instead of data; mixed-up response field semantics between message and data; inconsistent null handling across single objects, lists, and paginated results; conflation of HTTP status codes with business codes; and missing pre-generation validation when exporting Excel, CSV, or PDF files. The last point is especially critical — an export can return HTTP 200 and produce a valid file while WeChat import, reconciliation systems, or logistics platforms silently reject it due to missing mchId, transactionId, or shipping company fields. The skill is aimed at Java backend developers who design API contracts and generate downstream artifacts for external platforms.