openapi

type ApiInfo struct {
	OpenAPICli `json:"open_api_json"`
	Enable     `json:"enable"`
	// contains filtered or unexported fields
}

type Enable struct {
	Get  map[string][]Parameter  `json:"get"`
	Post map[string]*RequestBody `json:"post"`
	Slot map[int]string          `json:"slot"` // slot_id:method-path
}

type EnableParams struct {
	// 不需要考虑同时设置get和post参数的情况
	GetParams  map[string]string `json:"get_params"` // key is request param-name and value is param-value
	PostParams *RequestBody      `json:"post_params"`
	Slot       int               `json:"slot"`
}

type Info struct {
	Title   string `json:"title"`
	Version string `json:"version"`
}

type MediaType struct {
	Schema interface{} `json:"schema"` // 使用interface{}来表示未知的内容
}

type OpenAPICli struct {
	OpenAPI string              `json:"openapi"`
	Info    Info                `json:"info"`
	Servers []Server            `json:"servers,omitempty"`
	Paths   map[string]PathItem `json:"paths"`
}

type OpenApi interface {
	SendGETMethod(path string, parameters []Parameter) ([]byte, error)
	SendPOSTMethod(path string, body RequestBody) ([]byte, error)
	SendPOSTMethodEx(path, ct string, body []byte) ([]byte, error)

	GetApiInfo() Info
	GetPaths() map[string]PathItem
	GetEnable() *Enable
}

type Operation struct {
	Summary     string              `json:"summary"`
	RequestBody *RequestBody        `json:"requestBody,omitempty"` // POST
	Parameters  []Parameter         `json:"parameters,omitempty"`  // GET
	Responses   map[string]Response `json:"responses"`             // 200, 400等
}

type Parameter struct {
	Name        string `json:"name"`
	In          string `json:"in"` // 通常是"query"、"header"等
	Description string `json:"description,omitempty"`
	Required    bool   `json:"required,omitempty"`
	Schema      Schema `json:"schema"`
}

type PathItem struct {
	Get  *Operation `json:"get,omitempty"`
	Post *Operation `json:"post,omitempty"`
}

type Property struct {
	Type string `json:"type"`
}

type RequestBody struct {
	Description string               `json:"description"`
	Content     map[string]MediaType `json:"content"`
}

type Response struct {
	Description string               `json:"description"`
	Content     map[string]MediaType `json:"content"` //key: such as application/json
}

type Schema struct {
	Type       string              `json:"type"`
	Properties map[string]Property `json:"properties,omitempty"`
}

type Server struct {
	URL         string `json:"url"`
	Description string `json:"description,omitempty"`
}