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

engineering

api-design-safety — это скилл для Claude Code, который обеспечивает безопасность проектирования REST API и предотвращает дефекты, приводящие к сбоям в нижестоящих системах. Скилл охватывает пять ключевых ловушек: неоднозначность перегрузки дженерик-методов в Java (когда String попадает в поле message вместо data), смешение семантики полей ответа, несогласованную обработку пустых значений (null / [] / {}), путаницу между HTTP-статусами и бизнес-кодами, а также отсутствие проверки обязательных полей перед генерацией файлов Excel, CSV и PDF. Особое внимание уделяется «тихим» отказам: файл генерируется успешно, API возвращает 200, но нижестоящая система — например, импорт в WeChat или система сверки — отклоняет данные из-за пустых критичных полей. Скилл незаменим для Java-разработчиков, которые проектируют API-ответы и формируют экспортные отчёты для внешних платформ.