parser

type APISpec struct {
	Title        string
	Description  string
	Version      string
	Servers      []Server
	Resources    []Resource
	SecurityDefs []SecurityDef
}

type Operation struct {
	ID          string
	Summary     string
	Description string
	Method      string
	Path        string
	Parameters  []Parameter
	RequestBody *RequestBody
	Security    []SecurityRequirement
}

type Parameter struct {
	Name        string
	In          string // path, query, header, cookie
	Description string
	Required    bool
	Type        string // string, integer, boolean, number, array
	Default     any
	Enum        []string
}

type Property struct {
	Name        string
	Type        string
	Description string
	Required    bool
	Default     any
	Enum        []string
}

type RequestBody struct {
	Description string
	Required    bool
	ContentType string
	Properties  []Property
}

type Resource struct {
	Name        string
	Description string
	Operations  []Operation
}

type SecurityDef struct {
	Name      string
	Type      string // apiKey, http
	In        string // header, query
	ParamName string
	Scheme    string // bearer, basic
}

type SecurityRequirement struct {
	SchemeName string
	Scopes     []string
}

type Server struct {
	URL         string
	Description string
}