swagger.json

{
    "openapi": "3.1.0",
    "info": { "title": "API", "description": "API", "version": "1.0.0" },
    "servers": [{ "url": "http://localhost:{port}", "description": "Local", "variables": { "port": { "default": "3000" } } }],
    "paths": {
        "/user/{{userId}}": {
            "get": {
                "operationId": "getUser",
                "tags": ["auth"],
                "parameters": [
                    { "in": "query", "name": "status", "required": true, "schema": {} },
                    { "in": "path", "name": "userId", "required": true, "schema": {} }
                ],
                "responses": {
                    "default": {
                        "description": "Success Response",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "properties": {
                                        "user": {
                                            "type": "object",
                                            "additionalProperties": false,
                                            "properties": {
                                                "userId": { "type": "string" },
                                                "status": { "type": "string", "enum": ["pending", "success"] },
                                                "email": { "type": "string" }
                                            },
                                            "required": ["email", "status", "userId"]
                                        }
                                    },
                                    "required": ["user"],
                                    "additionalProperties": false
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "tags": []
}