Comments (2)
Three points (two bad, one good):
1. The JSON Schema spec that you linked to is the latest version (Draft-7), but OpenAPI 3.0 only supports the Wright Draft 00, which only has an example
keyword, not an examples
keyword.
2. OpenAPI is only a limited subset of JSON Schema. So not even all of the stuff in Wright Draft 00 is supported, and some things that are supported are limited or modified.
3. But here's the good news! OpenAPI has its own examples
property for both requests and responses. So you can rewrite your API definition like this:
openapi: 3.0.0
info:
description: Foobar
version: "1.0.0"
title: Foobar
paths:
'/foobar':
get:
responses:
'200':
description: this is a description
content:
application/json:
schema:
type: string
examples:
myFirstExample: aaaa
mySecondExample: bbb
from swagger-cli.
OK, that's a shame :)
Thanks anyway
from swagger-cli.
Related Issues (20)
- swagger-cli validation returns errors one by one
- invalid examples should not fail validation
- Dependabot warning for validator
- $ref bug resolving an existing folder HOT 1
- swagger-cli validate does not ensure unique operationIds
- Validate security keys against securitySchemes HOT 1
- Error: Token "Components" Does Not Exist HOT 6
- Combining multiple files can create circular references HOT 1
- Ref incorrect if path contains "{" or "}" HOT 1
- Bad error message on incorrect path provided
- Latest version of the CLI I'm getting the following error HOT 5
- bundle and validate commands are failing due to swagger-parser HOT 3
- Validation of composite keywords (anyOf, oneOf, allOf) HOT 1
- False positive: #/servers/0/variables/someParameter must NOT have unevaluated properties
- Undeclared parameters in server url should not validate
- Property examples are converted to the wrong date format
- The order of the directive changes between versions of the dependent package
- Combining multiple files into one keeps references to some api files HOT 1
- [BUG] String enum of '08' and '09 ' are wrong bundled HOT 1
- bundle removes quotes
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-cli.