parser

type Body struct {
	Description string
	Required    bool
	Content     []MediaType
}

type Doc struct {
	Title       string
	Version     string
	Description string
	Servers     []string
	Tags        []TagGroup
}

type Endpoint struct {
	Method      string // uppercase: GET, POST, …
	Path        string
	Summary     string
	Description string
	Deprecated  bool
	Parameters  []Parameter
	RequestBody *Body
	Responses   []Response
}

type MediaType struct {
	Type   string // e.g. "application/json"
	Schema *Schema
}

type Parameter struct {
	Name        string
	In          string // path, query, header, cookie
	Required    bool
	Description string
	Schema      *Schema
}

type Property struct {
	Name     string
	Required bool
	Schema   *Schema
}

type Response struct {
	Code        string
	Description string
	Content     []MediaType
}

type Schema struct {
	Type        string
	Format      string
	Description string
	Enum        []string
	Properties  []Property
	Items       *Schema // for array types
	Ref         string  // original $ref name if this was a reference
}

type TagGroup struct {
	Name        string
	Description string
	Endpoints   []Endpoint
}