dotnet-webapi

Create ASP.NET Core Web API endpoints with HTTP semantics and OpenAPI configuration.

Updated Aug 26, 2024
One-click install
npx skills add https://github.com/FabienDehopre/my-netatmo-24 --skill dotnet-webapi-fabiendehopre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotnet-webapi
Source: https://github.com/FabienDehopre/my-netatmo-24/tree/main/.agents/skills/dotnet-webapi
Command: npx skills add https://github.com/FabienDehopre/my-netatmo-24 --skill dotnet-webapi-fabiendehopre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers create and modify ASP.NET Core Web API endpoints correctly by applying consistent HTTP semantics, documentation practices, validation, and error handling patterns.

Core Features & Use Cases

  • API Endpoint Development: Guides creation of controller-based or minimal API endpoints with appropriate request and response models, status codes, and service-layer separation.
  • OpenAPI and Error Handling Setup: Helps configure API documentation, metadata, Problem Details responses, and centralized exception handling for production-ready services.
  • Use Case: Use this Skill when adding a new REST endpoint, documenting an existing API, creating API test requests, or improving error handling middleware in a.NET application.

Quick Start

Use the dotnet-webapi skill to add a new ASP.NET Core API endpoint with proper OpenAPI metadata, validation, and error handling.

Frequently Asked Questions about dotnet-webapi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an ASP.NET Core Web API endpoint with correct HTTP status codes?

Create ASP.NET Core Web API endpoints by structuring controllers or minimal APIs with appropriate request and response models, ensuring status code consistency and service-layer separation for maintainable API patterns.

What is the best way to configure OpenAPI documentation for an ASP.NET Core Web API?

Configure OpenAPI documentation for an ASP.NET Core Web API by setting up API metadata and documentation practices within your application, ensuring REST endpoints are properly documented and production-ready for consumers.

How do I set up global error handling and Problem Details responses in an ASP.NET Core API?

Set up global error handling in an ASP.NET Core API by configuring centralized exception handling middleware and Problem Details responses, providing consistent error reporting across all API endpoints for production-ready services.

Can I use minimal APIs instead of controllers for ASP.NET Core endpoint development?

Yes, ASP.NET Core endpoint development supports both controller-based and minimal API approaches, including proper endpoint creation, DTO design, validation, and OpenAPI configuration for production-ready REST implementations.

What's the difference between controller-based and minimal API patterns for ASP.NET Core Web APIs?

Controller-based APIs use explicit controller classes for endpoint organization, while minimal APIs use lightweight lambda expressions, but both patterns support proper HTTP semantics, validation, and error handling when building reliable ASP.NET Core APIs.