API Documentation

using GenHTTP.Engine.Internal;

using GenHTTP.Api.Content;
using GenHTTP.Api.Protocol;

using GenHTTP.Modules.ApiBrowsing;
using GenHTTP.Modules.Layouting;
using GenHTTP.Modules.OpenApi;
using GenHTTP.Modules.Practices;
using GenHTTP.Modules.Reflection;
using GenHTTP.Modules.Webservices;

var app = Layout.Create()
                .AddService<BookService>("books")
                .AddOpenApi() // GET /openapi.json (or .yaml)
                .AddSwaggerUi() // GET /swagger/
                .AddRedoc() // GET /redoc/
                .AddScalar(title: "Book API"); // GET /scalar/

await Host.Create()
          .Handler(app)
          .Defaults()
          .RunAsync();

public record Book(int Id, string Title);

public class BookService
{
    private static readonly List<Book> Books = [new(1, "Lord of the Rings")];

    [ResourceMethod]
    public List<Book> List()
    {
        lock (Books) return [..Books];
    }

    [ResourceMethod(":id")]
    public Book Get(int id)
    {
        lock (Books)
        {
            return Books.FirstOrDefault(b => b.Id == id) ?? throw new ProviderException(ResponseStatus.NotFound, $"There is no book with id {id}");
        }
    }

    [ResourceMethod(Method.Put)]
    public Book Create(Book book)
    {
        lock (Books)
        {
            if (Books.Count >= 50)
            {
                throw new ProviderException(ResponseStatus.Conflict, "The shelf is full, please delete a book first");
            }

            var added = book with { Id = Books.Select(b => b.Id).DefaultIfEmpty().Max() + 1 };

            Books.Add(added);

            return added;
        }
    }

    [ResourceMethod(Method.Delete, ":id")]
    public void Delete(int id)
    {
        lock (Books) Books.RemoveAll(b => b.Id == id);
    }

}