Приходилось ли проектировать API? Использовали OpenAPI, Swagger?

Да, приходилось проектировать API. Для описания и документирования RESTful API использовал OpenAPI Specification (ранее известный как Swagger). Это позволяет формализовать структуру API, описать эндпоинты, методы, параметры и модели данных, а также автоматически генерировать документацию и клиентские SDK.

Пример простого описания эндпоинта в 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