What problem does it solve?
This Skill provides a comprehensive guide to developing ASP.NET Core Web APIs with proper HTTP semantics, OpenAPI documentation, and error handling, streamlining the API development process.
Core Features & Use Cases
- Guided API Development: Step-by-step instructions for creating and modifying Web API endpoints.
- OpenAPI/Swagger Integration: Wiring up OpenAPI/Swagger metadata and documentation.
- DTO Management: Best practices for defining and using Data Transfer Objects (DTOs).
- Endpoint Organization: Strategies for structuring endpoints with static classes and methods.
- Error Handling: Setting up centralized error handling middleware and mapping exceptions to status codes.
- Use Case: If you're building a new Web API in ASP.NET Core and need to ensure your endpoints are well-documented, follow the guidelines in this Skill.
Quick Start
Implement the 'dotnet-webapi' skill in your project to generate a new controller with OpenAPI documentation and error handling for CRUD operations on 'Product' entities.