Да, опыт есть. Swagger (теперь OpenAPI Specification) используется для описания RESTful API в формате YAML или JSON. В спецификации описываются пути (endpoints), методы (GET, POST и т.д.), параметры запросов, структуры данных (модели), ответы и коды ошибок. Это позволяет автоматически генерировать документацию, клиентские SDK и серверные заглушки.

Пример простого описания GET запроса в OpenAPI (YAML):

paths:
  /users:
    get:
      summary: Получить список пользователей
      responses:
        '200':
          description: Успешный ответ
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string

Есть ли опыт написания спецификации в Swagger или OpenAPI?