Hey guys, don’t know whether I am on the good room for this question.
I am playing with
I am playing with
swagger-jsdoc to generate APIs documentation. I was wonderring whether it is possible to declare my definitions in a separate .yaml file and make sure they are part of the generated documentation eventually.
I know it is possible by just declaring the definitions in a comment block with the keyword
@swagger, but not sure it is possible with a .yaml file
Hi! Could anyone recommend solutions to generate PDF from swagger API specification?
I did some search and found this approach:
https://stackoverflow.com/questions/30217910/generate-pdf-from-swagger-api-documentation#answer-41257222
It would be nice to have "Save as PDF" function in Swagger editor.
@miqui
swagger-tools has that. There is also a sway-based one but it's not been updated a lot: https://github.com/whitlockjc/swagger-lint
@Chaz6 - not that i know of, i always check apis.guru to get ideas on other APIs
has anyone here gotten around that?
The obvious LMGTFY answer is swagger-restify, but it asks for a parameter: "
swaggerUI -> Where is your swagger-ui?" which in the example points to what seems like Swagger UI either checked into the repo (which I don't think is a good practice), or previously automatically generated (which I don't know how to do)
Got issue on asp.net core seems like Authorization on bearer not working at all?
here is my code:
swagg.AddSecurityDefinition("Bearer", new ApiKeyScheme
{
Description = "Desc here",
Name = "Authorization",
In = "header",
Type = "apiKey"
});
Hi, I'm trying to seprate the connect http app that uses swagger tools initializeMiddleware function to to add middlewares to the app but the thing is that it is async and I need to make sure that the all the middlewares are intialized beofre I export the app to use it for testing
@whitlockjc i checked this thread apigee-127/swagger-tools#495 thread already and it seems that there no way to make sure that all the middlewares are intialized before exporting the app, I'm just wondering now if i want to write integration tests using supertest, I need a seprate app module that has the the http server app alone wether express or connect or any
Hey, anyone has example how to generate generic types using swagger json? for example if i have
ItemsCollection<T> class in C# and return ItemsCollection<Country> from my API, generated models in typescript generated as ItemsCollectionCountry instead of generic type ItemsCollection<T>
"is not a valid integer" seems pretty specific.
@Meldiron ^^^
I cannot seem to use this with module exported like
export default module_name
x-swagger-router-controller does not link up to module
I was wondering if any of you know a tool like https://stoplight.io/platform/prism/ that s open-source?
Hello, I am new to swagger and Open API specification, would like to know if there is any solution to this issue. thanks OAI/OpenAPI-Specification#1656
I checkout the tag
v0.10.4
Hello, everyone. I'm writing a Restful API document. There are lot's of API that return pagination results. For example: {"count": 1024, "next": null, "previous": null, "results": [.....]}, what in the "result" array are my really definitions.
Can I define the pagination information and reuse it for multiple APIs?
Can I define the pagination information and reuse it for multiple APIs?
We have been trying to achieve configuring Swagger on Aspnet Core Identity Server 4 Application, we have added Custom End points to ID4 refered from link.
Swagger Configuration:
Code added on Startup.cs > ConfigureServices(IServiceCollection services)
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "Identity Server Application", Version = "v1" });
});
Code added on Startup.cs > Configure(IApplicationBuilder app)
// Enable middleware to serve generated Swagger as a JSON endpoint.
app.UseSwagger();
// Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.),
// specifying the Swagger JSON endpoint.
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Identity Server Application");
});When i run application swagger/index.html only showing Custom Added End Points,its not showing Identity Server Endpoints like {connect/authorize,connect/token,connect/userinfo etc.}
is there way to achieve above functionality.
can any one give me right direction to achieve above functionality
Hello guys. I got a quick question. I am using go-swagger to generate my swagger.json and render it with both ReDoc and SwaggerUI.
I wante to achieve what i see on the left side of https://redocly.github.io/redoc/#tag/user , which means categories with models underneath them.
eg.
General > pet, store
User Management > user
I am using OpenAPI 2.0 specifications but i can only get it to show pet,store,user and not split them in categories.
I wante to achieve what i see on the left side of https://redocly.github.io/redoc/#tag/user , which means categories with models underneath them.
eg.
General > pet, store
User Management > user
I am using OpenAPI 2.0 specifications but i can only get it to show pet,store,user and not split them in categories.
it's client code for c# net6.0
ideally I want to add the nuget package for dotnet core swagger-gen and then somehow make sure the code is generated. But all the examples I found are about not about that part but instead about how to get the openapi file or the swagger ui, I'm interested how I can create client code from an openapi.json.