| swagger: "2.0" | |
| info: | |
| title: Multiple basePaths | |
| version: 1.0.0 | |
| description: | | |
| Multiple basePaths aren't a feature in OpenAPI 2.0 (fka Swagger 2.0). | |
| A basePath only works if _all_ your endpoints have it in there. | |
| If your endpoints don't all share a comman basePath, you should leave it as `/` or blank. | |
| swagger: '2.0' | |
| info: | |
| title: Example to describe swagger codegen issue | |
| description: | | |
| Example Definition with Timestamp class as `java.sql.Timestamp` instead of custom model. | |
| version: v1 | |
| paths: | |
| /foo: | |
| post: |
| openapi: 3.0.3 | |
| info: | |
| title: Example multiple responses | |
| description: Example of multiple responses | |
| version: 1.0.0 | |
| paths: | |
| /one: | |
| post: | |
| description: Multiple request/response types. |
This is to demonstrate the use-case of Overlays for documentation writers.
The original.json file was generated from a swagger-core sample (aka Code-first) and
original.yml is the same definition but in YAML.
This is an effort of using real tools and as close to real issues as possible. Instead of simpler conrvied examples, although going forward simpler examples will be better (for readability at least)!
When we stick this into https://editor.swagger.io we find the following errors...
| openapi: 3.0.1 | |
| info: | |
| version: 1.1.1 | |
| title: XML attributes | |
| paths: | |
| /foo: | |
| get: | |
| responses: | |
| default: | |
| description: ok |
| swagger: '2.0' | |
| info: | |
| title: Recursive | |
| description: Recursive | |
| version: 1.0.0 | |
| paths: | |
| /foo: | |
| get: | |
| description: ok |
| apiVersion: apps/v1 | |
| kind: ReplicaSet | |
| metadata: | |
| name: petstore | |
| namespace: default | |
| labels: | |
| app: petstore | |
| spec: | |
| replicas: 1 | |
| selector: |
A query language aimed at identifying locations within a JSON/YAML document. Inspired by JSON Pointer. This is heavily influenced by JSON Path of which it shares maybe 80% of the syntax. It didn't start of sharing that much but has grown towards JSON Path, as problems were solved.
The design goals
| <!DOCTYPE html> | |
| <!-- HTML for static distribution bundle build --> | |
| <html lang="en"> | |
| <head> | |
| <meta charset="UTF-8"> | |
| <title>Swagger Editor</title> | |
| <style> | |
| * { | |
| box-sizing: border-box; | |
| } |
| openapi: 3.0.0 | |
| info: | |
| version: abc | |
| title: Showing a generated example for `additionalProperties` | |
| paths: | |
| /foo: | |
| get: | |
| description: ok |