openapi

type Endpoint struct {
	Path        string   `json:"path"`
	Method      string   `json:"method"`
	Summary     string   `json:"summary"`
	Description string   `json:"description,omitempty"`
	Scopes      []string `json:"scopes,omitempty"`
	Resource    string   `json:"resource,omitempty"` // e.g. "users", "groups", "messages"
}

type Index struct {
	Endpoints []Endpoint `json:"endpoints"`
}

type SearchResult struct {
	Endpoint
	MatchReason string `json:"matchReason"`
}