openapi

type Operation struct {
	Method      string                     `json:"method"`
	Path        string                     `json:"path"`
	OperationID string                     `json:"operationId,omitempty"`
	Summary     string                     `json:"summary,omitempty"`
	Description string                     `json:"description,omitempty"`
	Parameters  []Parameter                `json:"parameters,omitempty"`
	RequestBody *RequestBodySchema         `json:"requestBody,omitempty"`
	Response    *ResponseSchema            `json:"response,omitempty"`
	Responses   map[string]*ResponseSchema `json:"responses,omitempty"`
	RawSchema   map[string]any             `json:"rawResponseSchema,omitempty"`
}

type Parameter struct {
	Name     string         `json:"name"`
	In       string         `json:"in"`
	Required bool           `json:"required"`
	Schema   map[string]any `json:"schema,omitempty"`
}

type RequestBodySchema struct {
	Required bool           `json:"required"`
	Schema   map[string]any `json:"schema,omitempty"`
}

type ResponseSchema struct {
	Description string         `json:"description,omitempty"`
	Schema      map[string]any `json:"schema"`
}

type Spec struct {
	Operations  []*Operation
	RawContent  []byte
	ContentType string // "json" or "yaml"
	Version     string
}