mock-to-openapi

JSON mock to OpenAPI converter

Cli tool (and library) for converting JSON mock objects to OpenAPI schemas.

Install

npm install --global mock-to-openapi

Usage

Following command will convert all *.json files from directory ./examples to YAML OpenAPI schemas.

mock-to-openapi ./examples

Web Interface

You can use the online web interface to convert JSON mock objects to OpenAPI schemas directly in your browser:

https://ozzyczech.github.io/mock-to-openapi/

Example

Let's have, for example, json object with:

{
  "title": "This is title",
  "author": "Roman Ožana",
  "content": "This is just an example",
  "date": "2020-05-12T23:50:21.817Z"
}

Tool mock-to-openapi converts JSON to the OpenAPI specification as follows:

type: object
properties:
  title:
    type: string
    example: This is title
  author:
    type: string
    example: Roman Ožana
  content:
    type: string
    example: This is just an example
  date:
    type: string
    format: date-time
    example: 2020-05-12T23:50:21.817Z