Конвертеры и генераторы кода

Просмотрщик OpenAPI

Спека разворачивается в список эндпоинтов с параметрами, телами, кодами ответов и схемами. Понимает OpenAPI 3.x и Swagger 2.0, JSON и YAML.

Спецификация (JSON или YAML)

openapi: 3.0.3
info:
  title: Витрина API
  version: 1.2.0
  description: Небольшая спека для примера.
servers:
  - url: https://api.example.com/v1
paths:
  /users:
    get:
      tags: [Пользователи]
      summary: Список пользователей
      parameters:
        - name: page
          in: query
          schema: { type: integer }
          description: Номер страницы
      responses:
        '200':
          description: Список
          content:
            application/json:
              schema:
                type: array
                items: { $ref: '#/components/schemas/User' }
    post:
      tags: [Пользователи]
      summary: Создать пользователя
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: '#/components/schemas/User' }
      responses:
        '201': { description: Создан }
  /users/{id}:
    get:
      tags: [Пользователи]
      summary: Один пользователь
      parameters:
        - name: id
          in: path
          required: true
          schema: { type: string }
      responses:
        '200':
          description: Пользователь
          content:
            application/json:
              schema: { $ref: '#/components/schemas/User' }
        '404': { description: Не найден }
components:
  schemas:
    User:
      type: object
      required: [id, email]
      properties:
        id: { type: integer, description: Идентификатор }
        email: { type: string, format: email }
        role: { type: string, enum: [admin, editor, viewer] }

Выбрать файл…

Файл читается в браузере и никуда не отправляется.