refactor(api): inject IEmailSyncService into SyncController; change OAuth2 authorize route to username param; add Swagger UI metadata and description links

This commit is contained in:
2026-08-17 16:05:43 +02:00
parent 8925428e46
commit 993d9cfea0
3 changed files with 55 additions and 19 deletions

View File

@@ -69,7 +69,35 @@ try
builder.Services.AddControllers();
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddSwaggerGen(options =>
{
options.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo
{
Title = "DigitalData MessagingService API",
Version = "v1",
Description = """
Die **DigitalData MessagingService API** stellt Endpunkte zur Verwaltung von E-Mail-Konten,
E-Mail-Profilen sowie zur Verarbeitung und Nachverfolgung eingehender und ausgehender Nachrichten bereit.
---
## Authentifizierung
Für OAuth2-geschützte Endpunkte ist eine Authentifizierung erforderlich.
Rufen Sie den folgenden Endpunkt auf und ersetzen Sie `{E-Mail-Adresse}` durch die zu authentifizierende E-Mail-Adresse:
`/api/OAuth2/google/authorize/{E-Mail-Adresse}`
**Beispiel:** **[/api/OAuth2/google/authorize/htek0100@gmail.com →](/api/OAuth2/google/authorize/htek0100@gmail.com)**
---
## Weiterführende Links
- [Serilog Log-Viewer ↗](/serilog-ui)
"""
});
});
// Required by OAuth2Controller to build callback URIs
builder.Services.AddHttpContextAccessor();
@@ -92,14 +120,30 @@ try
// Add Serilog request logging
app.UseSerilogRequestLogging();
// Configure Swagger — enabled in Development always, and in other environments based on appsettings
// Configure Swagger <EFBFBD> enabled in Development always, and in other environments based on appsettings
var swaggerEnabled = app.Environment.IsDevelopment()
|| app.Configuration.GetValue<bool>("Swagger:Enabled");
if (swaggerEnabled)
{
app.UseSwagger();
app.UseSwaggerUI();
app.UseSwaggerUI(ui =>
{
ui.SwaggerEndpoint("/swagger/v1/swagger.json", "DigitalData MessagingService API v1");
// Inject CSS so all description links open in a new tab
ui.InjectStylesheet("data:text/css,.renderedMarkdown a{target:_blank}");
ui.InjectJavascript("data:text/javascript," + Uri.EscapeDataString("""
window.addEventListener('load', () => {
const observer = new MutationObserver(() => {
document.querySelectorAll('.renderedMarkdown a').forEach(a => {
a.setAttribute('target', '_blank');
a.setAttribute('rel', 'noopener noreferrer');
});
});
observer.observe(document.body, { childList: true, subtree: true });
});
"""));
});
}
app.UseHttpsRedirection();