MinApiLib.HashedIds

This package contains extensions to use hashed ids in your endpoints. It uses the Hashids library.

Installation

You can install this package using the NuGet package manager:

Install-Package MinApiLib.HashedIds

Or using the .NET CLI:

dotnet add package MinApiLib.HashedIds

Usage

To use hashed ids, you can add the AddHashedIds method in your Program.cs file:

global using MinApiLib.HashedIds; // ... builder.Services.AddHashedIds(op => op.Passphrase = "my secret passphrase");

Then, you can use the HashedId type in your endpoints:

public record struct Response(HashedId Id, string Name); public record Get() : GetEndpoint("/things") { public IResult Handle() => Results.Ok(new Response(1, "John Doe")); }

And test it with curl:

$ curl "http://localhost:5000/things" {"id":"Wd","name":"John Doe"}%

You can also use the HashedId type in your requests and responses:

public record struct Request(HashedId Id, CancellationToken CancellationToken); public record struct Response(HashedId Id, string Name); public record GetThing() : GetEndpoint<Request>("/things/{id}") { protected override Task<IResult> OnHandleAsync(Request request, CancellationToken cancellationToken) { int id = request.Id; var response = new Response(id, "John Doe"); return Task.FromResult(Results.Ok(response)); } }