swagger.json

{
    "openapi": "3.0.0",
    "info": {
      "title": "User API",
      "version": "1.0.0",
      "description": "API for managing users"
    },
    "paths": {
      "/api/users/{userId}": {
        "get": {
          "summary": "Get user by ID",
          "parameters": [
            {
              "name": "userId",
              "in": "path",
              "required": true,
              "description": "ID of the user",
              "schema": {
                "type": "string"
              }
            }
          ],
          "responses": {
            "200": {
              "description": "Successful response",
              "content": {
                "application/json": {
                  "example": {
                    "name": "John Doe",
                    "email": "john.doe@example.com",
                    "createdAt": "2022-02-03T12:34:56.789Z"
                  }
                }
              }
            },
            "400": {
              "description": "Invalid userId"
            },
            "404": {
              "description": "User not found"
            }
          }
        }
      },
      "/api/users": {
        "post": {
          "summary": "Create a new user",
          "requestBody": {
            "required": true,
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "email": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "name",
                    "email"
                  ]
                }
              }
            }
          },
          "responses": {
            "201": {
              "description": "User created"
            },
            "400": {
              "description": "Validation error"
            }
          }
        }
      }
    }
  }