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:
@@ -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();
|
||||
|
||||
Reference in New Issue
Block a user