Comments (5)
Hi @HenryGessau, there is yet another option to solve your case. While you can still use the recommended
ruleset as your base, you can turn the severity of that specific rule to off
and write your own configurable rule like this:
extends:
- recommended
rules:
operation-2xx-response: off
rule/operation-1xx-or-2xx-response:
subject:
type: Responses
assertions:
requireAny:
- '101'
- '200'
- ...
And then add as many required response codes as you need (probably all 2xx
s and maybe even the default
one). See more about configurable rules here.
This will ensure that every operation will have to contain at least one of the enlisted response codes.
from redocly-cli.
Thanks for the question! The recommended ruleset is aimed at being a solid recommendation for people with a basic API and little knowledge about APIs, to get them started in their API governance journey. Once up and running, almost all organisations should adjust the ruleset to fit their context, and I think that's the best approach here.
I'll close the issue since there's no action planned on our side, but please stay in touch if you have more comments or questions for us.
from redocly-cli.
@lornajane Understood on the goals of the recommended ruleset, but to be clear: we consider the operation-2xx-response
rule generally quite valuable - e.g., we have hundreds of operations in our API and only a couple that make use of 101
. Is there a way for us to off the check for a specific method (similar to being able to specify JSON pointers with Spectral rule overrides? That would enable us to keep the rule on in general while keeping the recommended ruleset simple.
from redocly-cli.
Yes there is! You can set an ignore for just the specific things you want to avoid having reported. The docs you want are over here: https://redocly.com/docs/cli/commands/lint/#generate-ignore-file
from redocly-cli.
@lornajane Unfortunately, with the ignore file approach, I end up with a problem similar to that described by #1224, as we generate multiple variants of our API (and furthermore, in our CI they are generated in temporary directories).
The solution in #1224 seems to be to create a custom plugin with an extension, but it is not clear to me how to write an extension for operation-2xx-response
. Do you have any suggestions?
from redocly-cli.
Related Issues (20)
- Support better means to set environment variables HOT 4
- dependentRequired is valid json schema but does not pass linting and prevents component from being available in UI. HOT 5
- Api HOT 2
- Add the `--ext` parameter to the `split` command HOT 1
- Running out of CPU inside of containers HOT 3
- join fails on commonly referenced components HOT 4
- Redocly removing string for enums if there's non-numbers mixed in HOT 3
- Ability to exclude some operations from security-defined rule HOT 4
- `remove-unused-components` removes used `securityDefinitions` from `Swagger 2.0` specifications HOT 1
- "join" remove extension properties under path property HOT 3
- Add option `--prefix-components-with-filepath` to `join` HOT 2
- Add `output` as a per-API configuration option
- Document behaviour of lint cli args after `--` HOT 3
- Configure object order for redocly bundle command HOT 2
- Unexpected theme/htmlTemplate config warnings in v1.15.0 HOT 7
- Redocly CLI Hangs When Running In A Container HOT 9
- HTML rendering broken / unusable when allOf and oneOf even if spec is considered 0 warning HOT 3
- Bundle command does not replace self-referencing files. HOT 3
- ContentSchema and bundling HOT 1
- Bundler Does Not Resolve Discriminator Mapping Values HOT 12
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 redocly-cli.