api-design
Набор рекомендаций и лучших практик для создания согласованных, удобных для разработчиков REST API.
Суть
Что это за skill и зачем он нужен
Этот навык предоставляет подробные рекомендации по проектированию API: структуру URL, правила именования, соответствие HTTP‑методов и статус‑кодов, форматы ответов, пагинацию, фильтрацию, сортировку, аутентификацию, авторизацию, ограничение запросов и стратегии версионирования. Включены примеры реализации на TypeScript (Next.js), Python (Django REST Framework) и Go, а также чек‑лист перед выпуском нового эндпоинта.
Установка
Как установить
npx skills add https://github.com/affaan-m/everything-claude-code --skill api-designСценарии
Когда использовать
Подходит
- Разработка новых REST‑эндпоинтов
- Ревизия существующих контрактов API
- Внедрение пагинации, фильтрации или сортировки
- Планирование стратегии версионирования публичных API
Не подходит
- Для генерации кода без последующего ручного контроля
- В проектах, где используется GraphQL или gRPC вместо REST
- Когда требуется динамическое изменение схемы API в рантайме
- Для простых микросервисов без публичного доступа, где избыточны рекомендации по версии и лимитам
Доверие
Проверки безопасности
Проверка вернула предупреждение. Перед установкой стоит просмотреть исходники, команды и доступы.
Проверка не нашла критичных проблем.
Низкий риск · проблем не найдено.
Предупреждений нет.
Проверка не нашла критичных проблем.
Похожие