Questions tagged [redoc]

94 questions
1
vote
0 answers

ReDocly Output with One Call Per Page?

Is it possible to generate output with Redocly or the Redocly CLI that has one request per page? And not all requests in a single, large, scrollable file? Commands like redoc-cli bundle -o index.html Sample.yaml create one file but with all the…
ForEachLoop
  • 2,508
  • 3
  • 18
  • 28
1
vote
2 answers

How to add a banner/label to redoc

Looking at the Redoc demo and they have used a "Webhook" label beside their title but I couldn't figure out how to implement it specifically for other labels. How would I be able to implement this to show a "Beta" label?
mocha
  • 45
  • 6
1
vote
0 answers

Is it possible to add authorization to ReDoc UI page? OPENAPI documentation

Is there a way to add authorization to redoc ui, so only registered users could have access to documentation and interactive api calls? Maybe, any integration with the Keycloak? API is using Flask, flask-smorest.
momo
  • 41
  • 1
  • 2
  • 5
1
vote
1 answer

Swagger/Redoc not showing

I am trying to get the XML comments working properly in the docs page, but am having trouble getting the to show. descriptions show just fine, but the remarks are missing completely. My Swagger config includes…
Dryden Long
  • 10,072
  • 2
  • 35
  • 47
1
vote
1 answer

Is there a way to import test files into redoc x-codeSamples source field?

The redoc guide specifies using raw text as source in a code sample: https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md#x-codeSamples like so: lang: JavaScript source: console.log('Hello World'); however I would like to…
nbenz
  • 41
  • 5
1
vote
0 answers

Displaying only certain properties of an OpenAPI reference

I didn't see anything specifically pertaining to this in the OpenAPI Reference, so I wanted to ask here for confirmation. Let's say I have a reference with the following data: components: schemas: Foobar: type: object …
Julian H. Lam
  • 25,501
  • 13
  • 46
  • 73
1
vote
0 answers

How to add Hierarchical Tags in Redoc

Currently Redoc only supports 2 depths of menu on the left hand panel. Is there any way, we can add one more depth? Someone has already created issue for this - https://github.com/Redocly/redoc/issues/1489
1
vote
1 answer

How to publish Redoc to gh-pages

I have completed the creation of docs using redoc along with all formatting. Now I want to publish it on github pages. There is a way where i can generate the static html pages using below command - npx redoc-cli bundle demo/openapi.yaml But one…
1
vote
0 answers

Some features tag is not working in .NET WebApi with ReDoc

I had installed Redoc with NSwag package in my WebApi projects. But I found that a lot of features are not working in the output API documents: No line break for the summary and remarks tag The tag of Example, code is not showing in the…
William Tang
  • 215
  • 1
  • 2
  • 8
1
vote
1 answer

Is it possible to pass an OpenAPI spec as a JSON object to ReDoc?

I created an OpenAPI JSON document for a RESTful service and am using ReDoc to display it. Is there a way to pass the OpenAPI spec as a JSON object directly to ReDoc without using a JSON file or URL? …
1
vote
2 answers

Redocly x-codeSamples Referenced File?

In Redocly, how is it possible to reference an external file in an x-codeSamples tag? The Redocly reference guide: https://redoc.ly/docs/api-reference-docs/vendor-extensions/redoc-supported-extensions/#x-codesamples In the following example, the…
ForEachLoop
  • 2,508
  • 3
  • 18
  • 28
1
vote
1 answer

drf-yasg: How to change operationId?

How do I change the name of the request that appears automatically in redoc-ui when using drf-yasg. For example: In the image, you can see that that the request is named fid_data-entities_update, it is picking this up from the URL. How do I…
1
vote
1 answer

Swagger schema properties ignored - why?

I'm trying to build a simple Swagger model: PlayerConfig: type: object required: - kind - player_id properties: kind: type: string example: PlayerConfig player_id: type: string example: "foo" …
Alex Ivanov
  • 393
  • 1
  • 5
  • 16
1
vote
1 answer

Sort by tags - Redoc UI

I have a swagger JSON where the tags are not in any particular order. I am trying to render this json in Redoc UI. Is there any way to render Redoc Ui with tags sorted alphabetically. Messages - API GET - API POST - API PUT - API…
1
vote
1 answer

Redoc side menu

I want to use Redoc for my API documentation. I also have swagger. I found here : https://github.com/Redocly/redoc this line - Integrate API Introduction into side menu - ReDoc takes advantage of markdown headings from OpenAPI description field. It…
andrey1567
  • 97
  • 1
  • 13