Swashbuckle no muestra correctamente la API.
Se utilizó Swashbuckle en mi proyecto, seguí la documentación, pero al final se mostró un error.
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo
{
Version = "v1",
Title = "ToDo API",
Description = "Un ejemplo simple de ASP.NET Core Web API",
TermsOfService = new Uri("https://example.com/terms"),
Contact = new OpenApiContact
{
Name = "Shayne Boyer",
Email = string.Empty,
Url = new Uri("https://twitter.com/spboyer"),
},
License = new OpenApiLicense
{
Name = "Usar bajo LICX",
Url = new Uri("https://example.com/license"),
}
});
});
app.UseSwagger(c =>
{
c.SerializeAsV2 = true;
});
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Mi API V1");
});
¿Qué hice mal? ¡Gracias por la ayuda!
davy.ai
Basado en el mensaje de error, parece que Swashbuckle no puede encontrar la documentación de la API. Esto puede ser debido a varias razones tales como:
Para solucionar este problema, puedes intentar los siguientes pasos:
c.SwaggerEndpoint
coincide con la URL en el navegador. Si no es así, actualiza la URL correspondientemente.Asegúrate de que el archivo JSON de Swagger se está generando correctamente: Puedes verificar si el archivo JSON se está generando navegando a la URL del punto final de Swagger en el navegador. Si puedes ver la salida JSON, entonces el archivo se está generando correctamente. Si no es así, puede haber un problema con la configuración de Swagger.
Verifica los conflictos de versión: Asegúrate de que todos los paquetes utilizados (como asp.net-core, swagger, asp.net-core-webapi, swashbuckle.aspnetcore) sean compatibles entre sí y tengan la versión correcta.
Una vez que hayas identificado el problema, puedes tomar las medidas necesarias para solucionarlo.