🚀 Getting Started¶

Welcome to CoreSystem.Http, a lightweight HTTP infrastructure library for ASP.NET Core and .NET 8.

This guide will help you capture and replay HTTP responses in just a few minutes.

By the end of this guide you will know how to:

Estimated time: 5 minutes

📋 Prerequisites¶

Before getting started, ensure you have:

Install the NuGet package.

dotnet add package CoreSystem.Http

Register the framework in the dependency injection container.

builder.Services.AddCoreHttp();

This registers all services required to capture and replay HTTP responses.

Inject the required services into your middleware, endpoint or application service.

public sealed class MyHandler(
    IResponseCapture responseCapture,
    IHttpResponseWriter responseWriter)
{
}

Both services are lightweight and registered by the framework.

Capture the HTTP response generated by the ASP.NET Core pipeline.

CapturedResponse response =
    await responseCapture.CaptureAsync(
        context,
        next,
        cancellationToken);

The captured response contains:

The original response is restored automatically after capture.

Replay a previously captured response.

await responseWriter.WriteAsync(
    context,
    response,
    cancellationToken);

The framework restores:

HEAD requests are handled automatically.

CoreSystem.Http is designed as reusable infrastructure.

Typical scenarios include:

Applications typically capture a response once and replay it multiple times depending on their business requirements.