koa-swagger

cd swagger-ui
npm install
cd ../swagger-editor
npm install

cd swagger-ui
npm start
cd ../swagger-editor
npm start

{
  "name": "koa-swagger",
  〃scripts": {
    "start": "pm2 start app.js --name=swagger"
  },
  "dependencies": {
    "koa": "^2.0.0",
    "koa-bodyparser": "^3.2.0",
    "koa-compress": "^2.0.0",
    "koa-convert": "^1.2.0",
    "koa-multer": "^1.0.2",
    "koa-router": "^7.0.1",
    "koa-static": "^4.0.2",
    "koa-static-cache": "^5.1.1",
    "koa2-cors": "^2.0.5"
  }
}

const Koa = require('koa')
const app = new Koa()
const path = require('path')
const bodyParser = require('koa-bodyparser')
const convert = require('koa-convert')
const staticCache = require('koa-static-cache')
const compress = require('koa-compress')
const cors = require('koa2-cors')

// Парсинг тела запроса
app.use(bodyParser())
```// Настройка CORS
app.use(convert(cors({
	allowMethods: ['GET', 'POST'],
    allowHeaders: ['Content-Type', 'Accept'],
    origin: function(ctx) {
        return '*' // локальная среда
    }
})))

// Настройка gzip
app.use(compress({
    threshold: 2048,
    flush: require("zlib").Z_SYNC_FLUSH
}))

// Сервер статических файлов, koa-swagger как корневая директория
app.use(convert(staticCache(path.join(__dirname, './'), {
    maxAge: 365 * 24 * 60 * 60,
    dynamic: false // динамическое обнаружение изменений файлов
}))))

## Серверный порт
```markdown
const port = 8882

app.listen(port, () => {
	console.log(`слушаем порт ${port} для swagger`)
})

npm install -g pm2

npm install

npm run start

// Build a system
const ui = SwaggerUIBundle({
    url: "http://localhost:8882/swagger.json", // Изменить на свой json файл конфигурации, используя swagger-editor
    dom_id: '#swagger-ui',
    deepLinking: true,
    presets: [
        SwaggerUIBundle.presets.apis,
        SwaggerUIStandalonePreset
    ],
    plugins: [
        SwaggerUIBundle.plugins.DownloadUrl
    ],
    layout: "StandaloneLayout"
})
```Скопировать swagger.json файл, созданный с помощью swagger-editor, в папку _/koa-swagger_. Мой swagger.json файл содержит следующее:

```markdown
swagger: "2.0"
info:
  version: "0.0.1"
  title: "react-talkweb"
host: localhost:8881
tags:
- name: "test"
  description: "Тестовые интерфейсы"
paths:
  /test/login:
    post:
      tags:
      - "test"
      summary: "Интерфейс входа"
      parameters:
      - name: "param"
        in: "body"
        description: "Параметры входа"
        required: true
        schema:
          $ref: '#/definitions/loginParam'
      responses:
        200:
          description: "Успех"

  /test/portal:
    post:
      tags:
      - "test"
      summary: "Интерфейс выбора системы"
      parameters:
      - name: "param"
        in: "body"
        description: "Параметры выбора системы"
        required: true
        schema:
          $ref: '#/definitions/portalParam'
      responses:
        200:
          description: "Успех"
  
  /test/home:
    post:
      tags:
      - "test"
      summary: "Интерфейс главной страницы"
      parameters:
      - name: "param"
        in: "body"
        description: "Параметры главной страницы"
        required: true
        schema:
          $ref: '#/definitions/homeParam'
      responses:
        200:
          description: "Успех"

pm2 restart all