Unify API route parameters, return IResult everywhere, merge picture upload DTOs and centralize validation limits

Guid and long route constraints, id/trackId parameter names, Update*Request without the New prefix,
sentence-case operation summaries, shared security scheme id and a single Limits class.
This commit is contained in:
2026-09-24 12:36:48 +02:00
parent 405df082cc
commit fcf3093ad8
38 changed files with 740 additions and 829 deletions
@@ -1,5 +1,6 @@
using Microsoft.Extensions.Options;
using Musify.Api.Authentication;
using Musify.Api.OpenApi;
using Scalar.AspNetCore;
namespace Musify.Api.Scalar;
@@ -7,25 +8,23 @@ namespace Musify.Api.Scalar;
public sealed class ScalarOptionsSetup(IOptions<AuthenticationConfiguration> options)
: IConfigureOptions<ScalarOptions>
{
private const string SecuritySchemeId = "OAuth2";
private readonly AuthenticationConfiguration _configuration = options.Value;
private readonly AuthenticationConfiguration configuration = options.Value;
public void Configure(ScalarOptions scalarOptions)
{
scalarOptions
.WithTitle("Musify API")
.AddPreferredSecuritySchemes(SecuritySchemeId)
.AddAuthorizationCodeFlow(SecuritySchemeId, flow =>
.AddPreferredSecuritySchemes(OpenApiOptionsSetup.SecuritySchemeId)
.AddAuthorizationCodeFlow(OpenApiOptionsSetup.SecuritySchemeId, flow =>
{
flow.ClientId = _configuration.ClientId;
flow.ClientSecret = _configuration.ClientSecret;
flow.AuthorizationUrl = _configuration.AuthorizationEndpoint;
flow.TokenUrl = _configuration.TokenEndpoint;
flow.ClientId = configuration.ClientId;
flow.ClientSecret = configuration.ClientSecret;
flow.AuthorizationUrl = configuration.AuthorizationEndpoint;
flow.TokenUrl = configuration.TokenEndpoint;
flow.Pkce = Pkce.Sha256;
flow.SelectedScopes = _configuration.Scopes;
flow.RedirectUri = _configuration.ScalarRedirectUri;
flow.RefreshUrl = _configuration.TokenEndpoint;
flow.SelectedScopes = configuration.Scopes;
flow.RedirectUri = configuration.ScalarRedirectUri;
flow.RefreshUrl = configuration.TokenEndpoint;
})
.HideModels();
}