/// <summary>
///     Represents a single HTTP endpoint (one path + one HTTP method).
/// </summary>
public sealed class OpenApiEndpoint
{
    /// <summary>HTTP method (GET, POST, PUT, DELETE, PATCH, etc.).</summary>
    public string Method { get; set; } = "";
    /// <summary>URL path template (e.g. <c>/users/{id}</c>).</summary>
    public string Path { get; set; } = "";
    /// <summary>Short summary of the endpoint.</summary>
    public string Summary { get; set; } = "";
    /// <summary>Longer description of the endpoint.</summary>
    public string Description { get; set; } = "";
    /// <summary>Unique operation identifier.</summary>
    public string OperationId { get; set; } = "";
    /// <summary>Whether this endpoint is marked as deprecated.</summary>
    public bool Deprecated { get; set; }
    /// <summary>Tags used to group this endpoint in the documentation.</summary>
    public List<string> Tags { get; } = [];
    /// <summary>Path, query, header, and cookie parameters.</summary>
    public List<OpenApiParameter> Parameters { get; } = [];
    /// <summary>Request body definition, if any.</summary>
    public OpenApiRequestBody? RequestBody { get; set; }
    /// <summary>Response definitions keyed by status code.</summary>
    public List<OpenApiResponse> Responses { get; } = [];
    /// <summary>Example JSON request body, if provided in the spec.</summary>
    public string? ExampleRequestJson { get; set; }
    /// <summary>Example JSON response body (typically from the first 2xx response), if provided.</summary>
    public string? ExampleResponseJson { get; set; }
}