Comments (2)
Hi @jorgemk85,
Your definition contains cycles and even though https://editor-next.swagger.io/ (SwaggerEditor@5) is based on ApiDOM which can handle cycles easily, we still seeing that error.
The issue is that for resolving
the definitions, we currently use dereference
algorithm (reference removal). Dereferencing can create cycles (circular references) and cycles cannot be serialized into JSON or YAML. In order to resolve this issue properly we need to use bundling
algorithm. We've already started some initial work on bundling in swagger-api/apidom#692.
What we can do for now to mitigate the issue (before we have bundling) is to run the dereferencing in replace mode and use circularReplacer
to make the circular reference absolute and skip resolving it.
from swagger-ui.
Hello @char0n,
Thank you for your reply.
I am using this "https://generator3.swagger.io/index.html#/clients/generate" endpoint to procedurally transform my spec files into "html2" static websites. Could you please indicate how to specify the dereferencing property in the request body? I have tried the following without making any difference:
{
"lang":"html2",
"spec":"...",
"specURL":null,
"type":"CLIENT",
"codegenVersion":"V3",
"options":{
"dereference":{
"circular":"replace"
}
}
}
from swagger-ui.
Related Issues (20)
- Name displayed instead of title only for OpenAPI 3.1 HOT 1
- Styling issues for OAS 3.1 and Swagger 2.x API documentations HOT 1
- Schemas not visible at all HOT 1
- Does swagger-ui 5.x support rendering AsyncAPIs? HOT 1
- Inconsistent Rendering of Schemas in Swagger UI for OpenAPI 3.1 Specification
- Is requestInterceptor is apply once when use in react?
- How to Make Examples Tab the Default Tab in Swagger UI?
- Hide parameter inputs in non-"Try it out" mode.
- Integer sample value does not adhere to minimum constraint (while number does) HOT 2
- When using oneOf for a property of a multipart/form-data, the json example is replaced by an empty string HOT 1
- Bug in parsing json objects as query params HOT 3
- Display schema for mutipart/form-data object properties
- change request url
- OpenAPI 3.x: add support for getting example values in request body for schemas with anyOf and allOf keywords when there are other properties HOT 1
- Expose functions for merging schemas from JSON schema samples plugins HOT 1
- swagger-ui-react option to enable pkce
- Error message formatting for nested parameters HOT 1
- Unnecessary -d '' in CURL when no request body
- Errors displaying schemas with oneOf HOT 4
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from swagger-ui.