MinimalApi.Responses 1.0.0

📦 MinimalApi.Responses

A lightweight, elegant, and type-safe API response wrapper for .NET Minimal APIs

✨ Why MinimalApi.Responses?

Stop writing boilerplate. Start delivering consistent APIs.

Every API needs a standard response format. Yet most projects end up reinventing the wheel---scattering inconsistent response logic across endpoints.
MinimalApi.Responses provides a clean, fluent interface that enforces consistent response shapes across your entire API with zero configuration.

// 🚫 Without this library - Inconsistent, verbose
return TypedResults.Json(new { Success = true, Data = user, Errors = Array.Empty<string>() });

// ✅ With this library - Clean, consistent, self-documenting
return endpoint.ApiSuccess(user);

🎯 Key Features

Feature Description

📦 Standardized Response ApiResponse<T>{=html} with consistent Wrapper success/error shape

🧹 Zero Boilerplate Clean extension methods eliminate repetitive code

🔄 Sync & Async Support Both synchronous and asynchronous helpers

⚠️ RFC 7807 Compliant Native Problem Details support for HTTP APIs

🎯 Type-Safe Full generic support with compile-time checking

📚 Self-Documenting Rich IntelliSense and XML documentation

🚀 Multi-Target Supports .NET 8.0, 9.0, and 10.0

📦 Installation

Package Manager Console

Install-Package MinimalApi.Responses

.NET CLI

dotnet add package MinimalApi.Responses

PackageReference

<PackageReference Include="MinimalApi.Responses" Version="1.0.0" />

🚀 Quick Start

using MinimalApi.Responses;

var app = WebApplication.CreateBuilder(args).Build();

app.MapGet("/users/{id}", (int id, object endpoint) =>
{
    var user = GetUserById(id);

    return user is not null
        ? endpoint.ApiSuccess(user)
        : endpoint.ApiFailure("User not found");
});

app.Run();

📋 Response Formats

✅ Success Response (200 OK)

{
  "success": true,
  "data": {
    "id": 1,
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com"
  },
  "errors": []
}

❌ Failure Response

{
  "success": false,
  "data": null,
  "errors": [
    "User not found"
  ]
}

⚠️ Problem Details (RFC 7807)

{
  "type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "title": "Validation Error",
  "status": 400,
  "detail": "The 'email' field must be a valid email address",
  "instance": "/api/users"
}

📄 License

MIT License
Free for personal and commercial use.

Built with ❤️ for the .NET community by Muammar Siddiqui