¿Ha tenido que diseñar API? ¿Usó OpenAPI, Swagger?

Sí, he tenido que diseñar API. Para describir y documentar API RESTful, utilicé OpenAPI Specification (anteriormente conocido como Swagger). Esto permite formalizar la estructura de la API, describir los endpoints, métodos, parámetros y modelos de datos, así como generar automáticamente documentación y SDKs de cliente.

Ejemplo de una descripción simple de un endpoint en OpenAPI (YAML):

paths:
  /users:
    get:
      summary: Obtener lista de usuarios
      responses:
        '200':
          description: Respuesta exitosa
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/User'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string