openapi3

package

Go to main page

Versions in this module

v0

v0.132.0

Feb 24, 2025

v0.131.0

Feb 24, 2025

Changes in this version

+ const FormatOfStringByte

+ const FormatOfStringDate

+ const FormatOfStringDateTime

+ const FormatOfStringForEmail

+ const FormatOfStringForUUIDOfRFC4122

+ const SerializationDeepObject

+ const SerializationForm

+ const SerializationLabel

+ const SerializationMatrix

+ const SerializationPipeDelimited

+ const SerializationSimple

+ const SerializationSpaceDelimited

+ const TypeArray

+ const TypeBoolean

+ const TypeInteger

+ const TypeNull

+ const TypeNumber

+ const TypeObject

+ const TypeString

+ var DefaultReadFromURI = URIMapCache(ReadFromURIs(ReadFromHTTP(http.DefaultClient), ReadFromFile))

+ var ErrOneOfConflict = errors.New("input matches more than one oneOf schemas")

+ var ErrURINotSupported = errors.New("unsupported URI")

+ var IdentifierRegExp = regexp.MustCompile(`^[` + identifierChars + `]+$`)

+ var InvalidIdentifierCharRegExp = regexp.MustCompile(`[^` + identifierChars + `]`)

+ var SchemaIntegerFormats = make(map[string]IntegerFormatValidator)

+ var SchemaNumberFormats = make(map[string]NumberFormatValidator)

+ func DefaultRefNameResolver(doc *T, ref ComponentRef) string

+ func DefineIPv4Format()

+ func DefineIPv6Format()

+ func DefineIntegerFormatValidator(name string, validator IntegerFormatValidator)

+ func DefineNumberFormatValidator(name string, validator NumberFormatValidator)

+ func DefineStringFormatCallback(name string, callback func(string) error)

+ func DefineStringFormatValidator(name string, validator StringFormatValidator)

+ func ReadFromFile(loader *Loader, location *url.URL) ([]byte, error)

+ func ReferencesComponentInRootDocument(doc *T, ref ComponentRef) (string, bool)

+ func RegisterArrayUniqueItemsChecker(fn SliceUniqueItemsChecker)

+ func WithValidationOptions(ctx context.Context, opts ...ValidationOption) context.Context

+ type AdditionalProperties struct

+ Has *bool

+ Schema *SchemaRef

+ func (addProps *AdditionalProperties) UnmarshalJSON(data []byte) error

+ func (addProps AdditionalProperties) MarshalJSON() ([]byte, error)

+ func (addProps AdditionalProperties) MarshalYAML() (any, error)

type Callback

+ Extensions map[string]any

+ Origin *Origin

+ func NewCallback(opts ...NewCallbackOption) *Callback

+ func NewCallbackWithCapacity(cap int) *Callback

+ func (callback *Callback) Delete(key string)

+ func (callback *Callback) Len() int

+ func (callback *Callback) Map() (m map[string]*PathItem)

+ func (callback *Callback) MarshalJSON() ([]byte, error)

+ func (callback *Callback) MarshalYAML() (any, error)

+ func (callback *Callback) Set(key string, value *PathItem)

+ func (callback *Callback) UnmarshalJSON(data []byte) (err error)

+ func (callback *Callback) Value(key string) *PathItem

+ func (callback Callback) JSONLookup(token string) (any, error)

type CallbackRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *CallbackRef) CollectionName() string

+ func (x *CallbackRef) JSONLookup(token string) (any, error)

+ func (x *CallbackRef) RefPath() *url.URL

+ func (x *CallbackRef) RefString() string

+ func (x CallbackRef) MarshalYAML() (any, error)

+ type Callbacks map[string]*CallbackRef

+ func (callbacks *Callbacks) UnmarshalJSON(data []byte) (err error)

+ func (m Callbacks) JSONLookup(token string) (any, error)

+ type ComponentRef interface

+ CollectionName func() string

+ RefPath func() *url.URL

+ RefString func() string

type Components

+ Extensions map[string]any

+ Origin *Origin

+ func (components Components) MarshalYAML() (any, error)

type Contact

+ Extensions map[string]any

+ Origin *Origin

+ func (contact *Contact) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (contact Contact) MarshalYAML() (any, error)

type Content

+ func NewContentWithFormDataSchema(schema *Schema) Content

+ func NewContentWithFormDataSchemaRef(schema *SchemaRef) Content

+ func NewContentWithSchema(schema *Schema, consumes []string) Content

+ func NewContentWithSchemaRef(schema *SchemaRef, consumes []string) Content

+ func (content *Content) UnmarshalJSON(data []byte) (err error)

+ type Discriminator struct

+ Extensions map[string]any

+ Mapping StringMap

+ Origin *Origin

+ PropertyName string

+ func (discriminator *Discriminator) UnmarshalJSON(data []byte) error

+ func (discriminator *Discriminator) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (discriminator Discriminator) MarshalJSON() ([]byte, error)

+ func (discriminator Discriminator) MarshalYAML() (any, error)

type Encoding

+ Extensions map[string]any

+ Origin *Origin

+ func (encoding *Encoding) SerializationMethod() *SerializationMethod

+ func (encoding Encoding) MarshalYAML() (any, error)

type Example

+ Extensions map[string]any

+ Origin *Origin

+ func (example *Example) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (example Example) MarshalYAML() (any, error)

type ExampleRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *ExampleRef) CollectionName() string

+ func (x *ExampleRef) JSONLookup(token string) (any, error)

+ func (x *ExampleRef) RefPath() *url.URL

+ func (x *ExampleRef) RefString() string

+ func (x ExampleRef) MarshalYAML() (any, error)

+ type Examples map[string]*ExampleRef

+ func (examples *Examples) UnmarshalJSON(data []byte) (err error)

+ func (m Examples) JSONLookup(token string) (any, error)

type ExternalDocs

+ Extensions map[string]any

+ Origin *Origin

+ func (e *ExternalDocs) UnmarshalJSON(data []byte) error

+ func (e *ExternalDocs) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (e ExternalDocs) MarshalJSON() ([]byte, error)

+ func (e ExternalDocs) MarshalYAML() (any, error)

+ type FormatValidator interface

+ Validate func(value T) error

+ func NewCallbackValidator[T any](fn func(T) error) FormatValidator[T]

+ func NewIPValidator(isIPv4 bool) FormatValidator[string]

+ func NewRangeFormatValidator[T int64 | float64](min, max T) FormatValidator[T]

type Header

+ func (header *Header) SerializationMethod() (*SerializationMethod, error)

+ func (header *Header) UnmarshalJSON(data []byte) error

+ func (header Header) JSONLookup(token string) (any, error)

+ func (header Header) MarshalJSON() ([]byte, error)

+ func (header Header) MarshalYAML() (any, error)

type HeaderRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *HeaderRef) CollectionName() string

+ func (x *HeaderRef) JSONLookup(token string) (any, error)

+ func (x *HeaderRef) RefPath() *url.URL

+ func (x *HeaderRef) RefString() string

+ func (x HeaderRef) MarshalYAML() (any, error)

+ type Headers map[string]*HeaderRef

+ func (headers *Headers) UnmarshalJSON(data []byte) (err error)

+ func (m Headers) JSONLookup(token string) (any, error)

type Info

+ Extensions map[string]any

+ Origin *Origin

+ func (info *Info) MarshalYAML() (any, error)

+ func (info *Info) Validate(ctx context.Context, opts ...ValidationOption) error

+ type IntegerFormatValidator = FormatValidator[int64]

type License

+ Extensions map[string]any

+ Origin *Origin

+ func (license *License) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (license License) MarshalYAML() (any, error)

type Link

+ Extensions map[string]any

+ OperationRef string

+ Origin *Origin

+ RequestBody any

+ Server *Server

+ func (link Link) MarshalYAML() (any, error)

type LinkRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *LinkRef) CollectionName() string

+ func (x *LinkRef) JSONLookup(token string) (any, error)

+ func (x *LinkRef) RefPath() *url.URL

+ func (x *LinkRef) RefString() string

+ func (x LinkRef) MarshalYAML() (any, error)

+ type Links map[string]*LinkRef

+ func (links *Links) UnmarshalJSON(data []byte) (err error)

+ func (m Links) JSONLookup(token string) (any, error)

+ type Loader struct

+ Context context.Context

+ IncludeOrigin bool

+ IsExternalRefsAllowed bool

+ ReadFromURIFunc ReadFromURIFunc

+ func NewLoader() *Loader

+ func (loader *Loader) LoadFromData(data []byte) (*T, error)

+ func (loader *Loader) LoadFromDataWithPath(data []byte, location *url.URL) (*T, error)

+ func (loader *Loader) LoadFromFile(location string) (*T, error)

+ func (loader *Loader) LoadFromIoReader(reader io.Reader) (*T, error)

+ func (loader *Loader) LoadFromStdin() (*T, error)

+ func (loader *Loader) LoadFromURI(location *url.URL) (*T, error)

+ func (loader *Loader) ResolveRefsIn(doc *T, location *url.URL) (err error)

+ type Location struct

+ Column int

+ Line int

type MediaType

+ Extensions map[string]any

+ Origin *Origin

+ func (mediaType MediaType) JSONLookup(token string) (any, error)

+ func (mediaType MediaType) MarshalYAML() (any, error)

+ type MultiError []error

+ func (me MultiError) As(target any) bool

+ func (me MultiError) Error() string

+ func (me MultiError) Is(target error) bool

+ type NewCallbackOption func(*Callback)

+ func WithCallback(cb string, pathItem *PathItem) NewCallbackOption

+ type NewPathsOption func(*Paths)

+ func WithPath(path string, pathItem *PathItem) NewPathsOption

+ type NewResponsesOption func(*Responses)

+ func WithName(name string, response *Response) NewResponsesOption

+ func WithStatus(status int, responseRef *ResponseRef) NewResponsesOption

+ type NumberFormatValidator = FormatValidator[float64]

type OAuthFlow

+ Extensions map[string]any

+ Origin *Origin

+ func (flow OAuthFlow) MarshalYAML() (any, error)

type OAuthFlows

+ Extensions map[string]any

+ Origin *Origin

+ func (flows OAuthFlows) MarshalYAML() (any, error)

type Operation

+ Extensions map[string]any

+ ExternalDocs *ExternalDocs

+ Origin *Origin

+ func (operation Operation) JSONLookup(token string) (any, error)

+ func (operation Operation) MarshalYAML() (any, error)

+ type Origin struct

+ Fields map[string]Location

+ Key *Location

type Parameter

+ Explode *bool

+ Extensions map[string]any

+ Origin *Origin

+ func (parameter *Parameter) SerializationMethod() (*SerializationMethod, error)

+ func (parameter Parameter) JSONLookup(token string) (any, error)

+ func (parameter Parameter) MarshalYAML() (any, error)

type ParameterRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *ParameterRef) CollectionName() string

+ func (x *ParameterRef) JSONLookup(token string) (any, error)

+ func (x *ParameterRef) RefPath() *url.URL

+ func (x *ParameterRef) RefString() string

+ func (x ParameterRef) MarshalYAML() (any, error)

type Parameters

+ func (p Parameters) JSONLookup(token string) (any, error)

+ type ParametersMap map[string]*ParameterRef

+ func (m ParametersMap) JSONLookup(token string) (any, error)

+ func (parametersMap *ParametersMap) UnmarshalJSON(data []byte) (err error)

type PathItem

+ Extensions map[string]any

+ Origin *Origin

+ Ref string

+ func (pathItem PathItem) MarshalYAML() (any, error)

type Paths

+ Extensions map[string]any

+ Origin *Origin

+ func NewPaths(opts ...NewPathsOption) *Paths

+ func NewPathsWithCapacity(cap int) *Paths

+ func (paths *Paths) Delete(key string)

+ func (paths *Paths) InMatchingOrder() []string

+ func (paths *Paths) Len() int

+ func (paths *Paths) Map() (m map[string]*PathItem)

+ func (paths *Paths) MarshalJSON() ([]byte, error)

+ func (paths *Paths) MarshalYAML() (any, error)

+ func (paths *Paths) Set(key string, value *PathItem)

+ func (paths *Paths) UnmarshalJSON(data []byte) (err error)

+ func (paths *Paths) Value(key string) *PathItem

+ func (paths Paths) JSONLookup(token string) (any, error)

+ type ReadFromURIFunc func(loader *Loader, url *url.URL) ([]byte, error)

+ func ReadFromHTTP(cl *http.Client) ReadFromURIFunc

+ func ReadFromURIs(readers ...ReadFromURIFunc) ReadFromURIFunc

+ func URIMapCache(reader ReadFromURIFunc) ReadFromURIFunc

+ type Ref struct

+ Origin *Origin

+ Ref string

+ type RefNameResolver func(*T, ComponentRef) string

+ type RegexCompilerFunc func(expr string) (RegexMatcher, error)

+ type RegexMatcher interface

+ MatchString func(s string) bool

+ type RequestBodies map[string]*RequestBodyRef

+ func (m RequestBodies) JSONLookup(token string) (any, error)

+ func (requestBodies *RequestBodies) UnmarshalJSON(data []byte) (err error)

type RequestBody

+ Extensions map[string]any

+ Origin *Origin

+ func (requestBody *RequestBody) WithFormDataSchema(value *Schema) *RequestBody

+ func (requestBody *RequestBody) WithFormDataSchemaRef(value *SchemaRef) *RequestBody

+ func (requestBody *RequestBody) WithSchema(value *Schema, consumes []string) *RequestBody

+ func (requestBody *RequestBody) WithSchemaRef(value *SchemaRef, consumes []string) *RequestBody

+ func (requestBody RequestBody) MarshalYAML() (any, error)

type RequestBodyRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *RequestBodyRef) CollectionName() string

+ func (x *RequestBodyRef) JSONLookup(token string) (any, error)

+ func (x *RequestBodyRef) RefPath() *url.URL

+ func (x *RequestBodyRef) RefString() string

+ func (x RequestBodyRef) MarshalYAML() (any, error)

type Response

+ Extensions map[string]any

+ Origin *Origin

+ func (response Response) MarshalYAML() (any, error)

+ type ResponseBodies map[string]*ResponseRef

+ func (m ResponseBodies) JSONLookup(token string) (any, error)

+ func (responseBodies *ResponseBodies) UnmarshalJSON(data []byte) (err error)

type ResponseRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *ResponseRef) CollectionName() string

+ func (x *ResponseRef) JSONLookup(token string) (any, error)

+ func (x *ResponseRef) RefPath() *url.URL

+ func (x *ResponseRef) RefString() string

+ func (x ResponseRef) MarshalYAML() (any, error)

type Responses

+ Extensions map[string]any

+ Origin *Origin

+ func NewResponsesWithCapacity(cap int) *Responses

+ func (responses *Responses) Delete(key string)

+ func (responses *Responses) Len() int

+ func (responses *Responses) Map() (m map[string]*ResponseRef)

+ func (responses *Responses) MarshalJSON() ([]byte, error)

+ func (responses *Responses) MarshalYAML() (any, error)

+ func (responses *Responses) Set(key string, value *ResponseRef)

+ func (responses *Responses) Status(status int) *ResponseRef

+ func (responses *Responses) UnmarshalJSON(data []byte) (err error)

+ func (responses *Responses) Value(key string) *ResponseRef

+ func (responses Responses) JSONLookup(token string) (any, error)

type Schema

+ AllowEmptyValue bool

+ Deprecated bool

+ Extensions map[string]any

+ Origin *Origin

+ Title string

+ func NewUUIDSchema() *Schema

+ func (schema *Schema) PermitsNull() bool

+ func (schema *Schema) WithDefault(defaultValue any) *Schema

+ func (schema *Schema) WithRequired(required []string) *Schema

+ func (schema *Schema) WithoutAdditionalProperties() *Schema

+ func (schema Schema) JSONLookup(token string) (any, error)

+ func (schema Schema) MarshalYAML() (any, error)

type SchemaError

+ func (err SchemaError) Unwrap() error

type SchemaRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *SchemaRef) CollectionName() string

+ func (x *SchemaRef) JSONLookup(token string) (any, error)

+ func (x *SchemaRef) RefPath() *url.URL

+ func (x *SchemaRef) RefString() string

+ func (x SchemaRef) MarshalYAML() (any, error)

+ type SchemaRefs []*SchemaRef

+ func (s SchemaRefs) JSONLookup(token string) (any, error)

+ type SchemaValidationOption func(*schemaValidationSettings)

+ func DefaultsSet(f func()) SchemaValidationOption

+ func DisablePatternValidation() SchemaValidationOption

+ func DisableReadOnlyValidation() SchemaValidationOption

+ func DisableWriteOnlyValidation() SchemaValidationOption

+ func EnableFormatValidation() SchemaValidationOption

+ func FailFast() SchemaValidationOption

+ func MultiErrors() SchemaValidationOption

+ func SetSchemaErrorMessageCustomizer(f func(err *SchemaError) string) SchemaValidationOption

+ func SetSchemaRegexCompiler(c RegexCompilerFunc) SchemaValidationOption

+ func VisitAsRequest() SchemaValidationOption

+ func VisitAsResponse() SchemaValidationOption

+ type Schemas map[string]*SchemaRef

+ func (m Schemas) JSONLookup(token string) (any, error)

+ func (schemas *Schemas) UnmarshalJSON(data []byte) (err error)

type SecurityRequirement

+ func (security *SecurityRequirement) UnmarshalJSON(data []byte) (err error)

type SecurityScheme

+ Extensions map[string]any

+ OpenIdConnectUrl string

+ Origin *Origin

+ func NewOIDCSecurityScheme(oidcUrl string) *SecurityScheme

+ func (ss SecurityScheme) MarshalYAML() (any, error)

type SecuritySchemeRef

+ Extensions map[string]any

+ Origin *Origin

+ func (x *SecuritySchemeRef) CollectionName() string

+ func (x *SecuritySchemeRef) JSONLookup(token string) (any, error)

+ func (x *SecuritySchemeRef) RefPath() *url.URL

+ func (x *SecuritySchemeRef) RefString() string

+ func (x SecuritySchemeRef) MarshalYAML() (any, error)

+ type SecuritySchemes map[string]*SecuritySchemeRef

+ func (m SecuritySchemes) JSONLookup(token string) (any, error)

+ func (securitySchemes *SecuritySchemes) UnmarshalJSON(data []byte) (err error)

+ type SerializationMethod struct

+ Explode bool

+ Style string

type Server

+ Extensions map[string]any

+ Origin *Origin

+ func (server *Server) BasePath() (string, error)

+ func (server *Server) UnmarshalJSON(data []byte) error

+ func (server Server) MarshalJSON() ([]byte, error)

+ func (server Server) MarshalYAML() (any, error)

type ServerVariable

+ Extensions map[string]any

+ Origin *Origin

+ func (serverVariable *ServerVariable) UnmarshalJSON(data []byte) error

+ func (serverVariable ServerVariable) MarshalJSON() ([]byte, error)

+ func (serverVariable ServerVariable) MarshalYAML() (any, error)

type Servers

+ func (servers Servers) BasePath() (string, error)

+ type SliceUniqueItemsChecker func(items []any) bool

+ type StringFormatValidator = FormatValidator[string]

+ func NewRegexpFormatValidator(pattern string) StringFormatValidator

+ type StringMap map[string]string

+ func (stringMap *StringMap) UnmarshalJSON(data []byte) (err error)

+ type T struct

+ Components *Components

+ Extensions map[string]any

+ ExternalDocs *ExternalDocs

+ Info *Info

+ OpenAPI string

+ Paths *Paths

+ Security SecurityRequirements

+ Servers Servers

+ Tags Tags

+ func (doc *T) AddOperation(path string, method string, operation *Operation)

+ func (doc *T) AddServer(server *Server)

+ func (doc *T) AddServers(servers ...*Server)

+ func (doc *T) InternalizeRefs(ctx context.Context, refNameResolver func(*T, ComponentRef) string)

+ func (doc *T) JSONLookup(token string) (any, error)

+ func (doc *T) MarshalJSON() ([]byte, error)

+ func (doc *T) MarshalYAML() (any, error)

+ func (doc *T) UnmarshalJSON(data []byte) error

+ func (doc *T) Validate(ctx context.Context, opts ...ValidationOption) error

type Tag

+ Extensions map[string]any

+ Origin *Origin

+ func (t *Tag) UnmarshalJSON(data []byte) error

+ func (t *Tag) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (t Tag) MarshalJSON() ([]byte, error)

+ func (t Tag) MarshalYAML() (any, error)

type Tags

+ func (tags Tags) Validate(ctx context.Context, opts ...ValidationOption) error

+ type Types []string

+ func (pTypes *Types) Includes(typ string) bool

+ func (pTypes *Types) MarshalJSON() ([]byte, error)

+ func (pTypes *Types) MarshalYAML() (any, error)

+ func (types *Types) Is(typ string) bool

+ func (types *Types) Permits(typ string) bool

+ func (types *Types) Slice() []string

+ func (types *Types) UnmarshalJSON(data []byte) error

+ type ValidationOption func(options *ValidationOptions)

+ func AllowExtensionsWithRef() ValidationOption

+ func AllowExtraSiblingFields(fields ...string) ValidationOption

+ func DisableExamplesValidation() ValidationOption

+ func DisableSchemaDefaultsValidation() ValidationOption

+ func DisableSchemaFormatValidation() ValidationOption

+ func DisableSchemaPatternValidation() ValidationOption

+ func EnableExamplesValidation() ValidationOption

+ func EnableSchemaDefaultsValidation() ValidationOption

+ func EnableSchemaFormatValidation() ValidationOption

+ func EnableSchemaPatternValidation() ValidationOption

+ func ProhibitExtensionsWithRef() ValidationOption

+ func SetRegexCompiler(c RegexCompilerFunc) ValidationOption

+ type ValidationOptions struct

+ type XML struct

+ Attribute bool

+ Extensions map[string]any

+ Name string

+ Namespace string

+ Origin *Origin

+ Prefix string

+ Wrapped bool

+ func (xml *XML) UnmarshalJSON(data []byte) error

+ func (xml *XML) Validate(ctx context.Context, opts ...ValidationOption) error

+ func (xml XML) MarshalJSON() ([]byte, error)

+ func (xml XML) MarshalYAML() (any, error)

v0.1.0

Sep 29, 2018

Changes in this version

+ const ParameterInCookie

+ const ParameterInHeader

+ const ParameterInPath

+ const ParameterInQuery

+ var ErrSchemaInputInf = errors.New("Inf is not allowed")

+ var ErrSchemaInputNaN = errors.New("NaN is not allowed")

+ var SchemaErrorDetailsDisabled = false

+ var SchemaStringFormats = make(map[string]*regexp.Regexp, 8)

+ func BoolPtr(value bool) *bool

+ func DefineStringFormat(name string, pattern string)

+ func Float64Ptr(value float64) *float64

+ func Int64Ptr(value int64) *int64

+ func Uint64Ptr(value uint64) *uint64

+ func ValidateIdentifier(value string) error

+ type Callback map[string]*PathItem

+ func (value Callback) Validate(c context.Context) error

+ type CallbackRef struct

+ Ref string

+ Value *Callback

+ func (value *CallbackRef) MarshalJSON() ([]byte, error)

+ func (value *CallbackRef) UnmarshalJSON(data []byte) error

+ func (value *CallbackRef) Validate(c context.Context) error

+ type Components struct

+ Callbacks map[string]*CallbackRef

+ Examples map[string]*ExampleRef

+ Headers map[string]*HeaderRef

+ Links map[string]*LinkRef

+ Parameters map[string]*ParameterRef

+ RequestBodies map[string]*RequestBodyRef

+ Responses map[string]*ResponseRef

+ Schemas map[string]*SchemaRef

+ SecuritySchemes map[string]*SecuritySchemeRef

+ Tags Tags

+ func NewComponents() Components

+ func (components *Components) MarshalJSON() ([]byte, error)

+ func (components *Components) UnmarshalJSON(data []byte) error

+ func (components *Components) Validate(c context.Context) (err error)

+ type Contact struct

+ Email string

+ Name string

+ URL string

+ func (value *Contact) MarshalJSON() ([]byte, error)

+ func (value *Contact) UnmarshalJSON(data []byte) error

+ type Content map[string]*MediaType

+ func NewContent() Content

+ func NewContentWithJSONSchema(schema *Schema) Content

+ func NewContentWithJSONSchemaRef(schema *SchemaRef) Content

+ func (content Content) Get(mime string) *MediaType

+ func (content Content) Validate(c context.Context) error

+ type Encoding struct

+ AllowReserved bool

+ ContentType string

+ Explode bool

+ Headers map[string]*HeaderRef

+ Style string

+ func NewEncoding() *Encoding

+ func (encoding *Encoding) MarshalJSON() ([]byte, error)

+ func (encoding *Encoding) UnmarshalJSON(data []byte) error

+ func (encoding *Encoding) Validate(c context.Context) error

+ func (encoding *Encoding) WithHeader(name string, header *Header) *Encoding

+ func (encoding *Encoding) WithHeaderRef(name string, ref *HeaderRef) *Encoding

+ type Example struct

+ Description string

+ ExternalValue string

+ Summary string

+ Value interface{}

+ func NewExample(value interface{}) *Example

+ func (example *Example) MarshalJSON() ([]byte, error)

+ func (example *Example) UnmarshalJSON(data []byte) error

+ type ExampleRef struct

+ Ref string

+ Value *Example

+ func (value *ExampleRef) MarshalJSON() ([]byte, error)

+ func (value *ExampleRef) UnmarshalJSON(data []byte) error

+ func (value *ExampleRef) Validate(c context.Context) error

+ type ExtensionProps struct

+ Extensions map[string]interface{}

+ func (props *ExtensionProps) DecodeWith(decoder *jsoninfo.ObjectDecoder, value interface{}) error

+ func (props *ExtensionProps) EncodeWith(encoder *jsoninfo.ObjectEncoder, value interface{}) error

+ type ExternalDocs struct

+ Description string

+ URL string

+ type Header struct

+ Description string

+ Schema *SchemaRef

+ func (value *Header) Validate(c context.Context) error

+ type HeaderRef struct

+ Ref string

+ Value *Header

+ func (value *HeaderRef) MarshalJSON() ([]byte, error)

+ func (value *HeaderRef) UnmarshalJSON(data []byte) error

+ func (value *HeaderRef) Validate(c context.Context) error

+ type Info struct

+ Contact *Contact

+ Description string

+ License *License

+ TermsOfService string

+ Title string

+ Version string

+ func (value *Info) MarshalJSON() ([]byte, error)

+ func (value *Info) UnmarshalJSON(data []byte) error

+ type License struct

+ Name string

+ URL string

+ func (value *License) MarshalJSON() ([]byte, error)

+ func (value *License) UnmarshalJSON(data []byte) error

+ type Link struct

+ Description string

+ Headers map[string]*Schema

+ Href string

+ OperationID string

+ Parameters map[string]interface{}

+ func (value *Link) MarshalJSON() ([]byte, error)

+ func (value *Link) UnmarshalJSON(data []byte) error

+ func (value *Link) Validate(c context.Context) error

+ type LinkRef struct

+ Ref string

+ Value *Link

+ func (value *LinkRef) MarshalJSON() ([]byte, error)

+ func (value *LinkRef) UnmarshalJSON(data []byte) error

+ func (value *LinkRef) Validate(c context.Context) error

+ type MediaType struct

+ Encoding map[string]*Encoding

+ Example interface{}

+ Examples map[string]*ExampleRef

+ Schema *SchemaRef

+ func NewMediaType() *MediaType

+ func (mediaType *MediaType) MarshalJSON() ([]byte, error)

+ func (mediaType *MediaType) UnmarshalJSON(data []byte) error

+ func (mediaType *MediaType) Validate(c context.Context) error

+ func (mediaType *MediaType) WithEncoding(name string, enc *Encoding) *MediaType

+ func (mediaType *MediaType) WithExample(name string, value interface{}) *MediaType

+ func (mediaType *MediaType) WithSchema(schema *Schema) *MediaType

+ func (mediaType *MediaType) WithSchemaRef(schema *SchemaRef) *MediaType

+ type OAuthFlow struct

+ AuthorizationURL string

+ RefreshURL string

+ Scopes map[string]string

+ TokenURL string

+ func (flow *OAuthFlow) MarshalJSON() ([]byte, error)

+ func (flow *OAuthFlow) UnmarshalJSON(data []byte) error

+ func (flow *OAuthFlow) Validate(c context.Context, typ oAuthFlowType) error

+ type OAuthFlows struct

+ AuthorizationCode *OAuthFlow

+ ClientCredentials *OAuthFlow

+ Implicit *OAuthFlow

+ Password *OAuthFlow

+ func (flows *OAuthFlows) MarshalJSON() ([]byte, error)

+ func (flows *OAuthFlows) UnmarshalJSON(data []byte) error

+ func (flows *OAuthFlows) Validate(c context.Context) error

+ type Operation struct

+ Callbacks map[string]*CallbackRef

+ Deprecated bool

+ Description string

+ OperationID string

+ Parameters Parameters

+ RequestBody *RequestBodyRef

+ Responses Responses

+ Security *SecurityRequirements

+ Servers *Servers

+ Summary string

+ Tags []string

+ func NewOperation() *Operation

+ func (operation *Operation) AddParameter(p *Parameter)

+ func (operation *Operation) AddResponse(status int, response *Response)

+ func (operation *Operation) MarshalJSON() ([]byte, error)

+ func (operation *Operation) UnmarshalJSON(data []byte) error

+ func (operation *Operation) Validate(c context.Context) error

+ type Parameter struct

+ AllowEmptyValue bool

+ AllowReserved bool

+ Content Content

+ Deprecated bool

+ Description string

+ Example interface{}

+ Examples map[string]*ExampleRef

+ In string

+ Name string

+ Required bool

+ Schema *SchemaRef

+ Style string

+ func NewCookieParameter(name string) *Parameter

+ func NewHeaderParameter(name string) *Parameter

+ func NewPathParameter(name string) *Parameter

+ func NewQueryParameter(name string) *Parameter

+ func (parameter *Parameter) MarshalJSON() ([]byte, error)

+ func (parameter *Parameter) UnmarshalJSON(data []byte) error

+ func (parameter *Parameter) Validate(c context.Context) error

+ func (parameter *Parameter) WithDescription(value string) *Parameter

+ func (parameter *Parameter) WithRequired(value bool) *Parameter

+ func (parameter *Parameter) WithSchema(value *Schema) *Parameter

+ type ParameterRef struct

+ Ref string

+ Value *Parameter

+ func (value *ParameterRef) MarshalJSON() ([]byte, error)

+ func (value *ParameterRef) UnmarshalJSON(data []byte) error

+ func (value *ParameterRef) Validate(c context.Context) error

+ type Parameters []*ParameterRef

+ func NewParameters() Parameters

+ func (parameters Parameters) GetByInAndName(in string, name string) *Parameter

+ func (parameters Parameters) Validate(c context.Context) error

+ type PathItem struct

+ Connect *Operation

+ Delete *Operation

+ Description string

+ Get *Operation

+ Head *Operation

+ Options *Operation

+ Parameters Parameters

+ Patch *Operation

+ Post *Operation

+ Put *Operation

+ Servers Servers

+ Summary string

+ Trace *Operation

+ func (pathItem *PathItem) GetOperation(method string) *Operation

+ func (pathItem *PathItem) MarshalJSON() ([]byte, error)

+ func (pathItem *PathItem) Operations() map[string]*Operation

+ func (pathItem *PathItem) SetOperation(method string, operation *Operation)

+ func (pathItem *PathItem) UnmarshalJSON(data []byte) error

+ func (pathItem *PathItem) Validate(c context.Context) error

+ type Paths map[string]*PathItem

+ func (paths Paths) Find(key string) *PathItem

+ func (paths Paths) Validate(c context.Context) error

+ type RequestBody struct

+ Content Content

+ Description string

+ Required bool

+ func NewRequestBody() *RequestBody

+ func (requestBody *RequestBody) GetMediaType(mediaType string) *MediaType

+ func (requestBody *RequestBody) MarshalJSON() ([]byte, error)

+ func (requestBody *RequestBody) UnmarshalJSON(data []byte) error

+ func (requestBody *RequestBody) Validate(c context.Context) error

+ func (requestBody *RequestBody) WithContent(content Content) *RequestBody

+ func (requestBody *RequestBody) WithDescription(value string) *RequestBody

+ func (requestBody *RequestBody) WithJSONSchema(value *Schema) *RequestBody

+ func (requestBody *RequestBody) WithJSONSchemaRef(value *SchemaRef) *RequestBody

+ func (requestBody *RequestBody) WithRequired(value bool) *RequestBody

+ type RequestBodyRef struct

+ Ref string

+ Value *RequestBody

+ func (value *RequestBodyRef) MarshalJSON() ([]byte, error)

+ func (value *RequestBodyRef) UnmarshalJSON(data []byte) error

+ func (value *RequestBodyRef) Validate(c context.Context) error

+ type Response struct

+ Content Content

+ Description string

+ Headers map[string]*Schema

+ Links map[string]*LinkRef

+ func NewResponse() *Response

+ func (response *Response) MarshalJSON() ([]byte, error)

+ func (response *Response) UnmarshalJSON(data []byte) error

+ func (response *Response) Validate(c context.Context) error

+ func (response *Response) WithContent(content Content) *Response

+ func (response *Response) WithDescription(value string) *Response

+ func (response *Response) WithJSONSchema(schema *Schema) *Response

+ func (response *Response) WithJSONSchemaRef(schema *SchemaRef) *Response

+ type ResponseRef struct

+ Ref string

+ Value *Response

+ func (value *ResponseRef) MarshalJSON() ([]byte, error)

+ func (value *ResponseRef) UnmarshalJSON(data []byte) error

+ func (value *ResponseRef) Validate(c context.Context) error

+ type Responses map[string]*ResponseRef

+ func NewResponses() Responses

+ func (responses Responses) Default() *ResponseRef

+ func (responses Responses) Get(status int) *ResponseRef

+ func (responses Responses) Validate(c context.Context) error

+ type Schema struct

+ AdditionalProperties *SchemaRef

+ AdditionalPropertiesAllowed *bool

+ AllOf []*SchemaRef

+ AnyOf []*SchemaRef

+ Default interface{}

+ Description string

+ Discriminator string

+ Enum []interface{}

+ Example interface{}

+ ExclusiveMax bool

+ ExclusiveMin bool

+ ExternalDocs interface{}

+ Format string

+ Items *SchemaRef

+ Max *float64

+ MaxItems *uint64

+ MaxLength *uint64

+ MaxProps *uint64

+ Min *float64

+ MinItems uint64

+ MinLength uint64

+ MinProps uint64

+ MultipleOf *float64

+ Not *SchemaRef

+ Nullable bool

+ OneOf []*SchemaRef

+ Pattern string

+ PatternProperties string

+ Properties map[string]*SchemaRef

+ ReadOnly bool

+ Required []string

+ Type string

+ UniqueItems bool

+ WriteOnly bool

+ XML interface{}

+ func NewAllOfSchema(schemas ...*Schema) *Schema

+ func NewAnyOfSchema(schemas ...*Schema) *Schema

+ func NewArraySchema() *Schema

+ func NewBoolSchema() *Schema

+ func NewBytesSchema() *Schema

+ func NewDateTimeSchema() *Schema

+ func NewFloat64Schema() *Schema

+ func NewInt32Schema() *Schema

+ func NewInt64Schema() *Schema

+ func NewIntegerSchema() *Schema

+ func NewObjectSchema() *Schema

+ func NewOneOfSchema(schemas ...*Schema) *Schema

+ func NewSchema() *Schema

+ func NewStringSchema() *Schema

+ func (schema *Schema) IsEmpty() bool

+ func (schema *Schema) IsMatching(value interface{}) bool

+ func (schema *Schema) IsMatchingJSONArray(value []interface{}) bool

+ func (schema *Schema) IsMatchingJSONBoolean(value bool) bool

+ func (schema *Schema) IsMatchingJSONNumber(value float64) bool

+ func (schema *Schema) IsMatchingJSONObject(value map[string]interface{}) bool

+ func (schema *Schema) IsMatchingJSONString(value string) bool

+ func (schema *Schema) MarshalJSON() ([]byte, error)

+ func (schema *Schema) NewRef() *SchemaRef

+ func (schema *Schema) UnmarshalJSON(data []byte) error

+ func (schema *Schema) Validate(c context.Context) error

+ func (schema *Schema) VisitJSON(value interface{}) error

+ func (schema *Schema) VisitJSONArray(value []interface{}) error

+ func (schema *Schema) VisitJSONBoolean(value bool) error

+ func (schema *Schema) VisitJSONNumber(value float64) error

+ func (schema *Schema) VisitJSONObject(value map[string]interface{}) error

+ func (schema *Schema) VisitJSONString(value string) error

+ func (schema *Schema) WithAdditionalProperties(v *Schema) *Schema

+ func (schema *Schema) WithAnyAdditionalProperties() *Schema

+ func (schema *Schema) WithEnum(values ...interface{}) *Schema

+ func (schema *Schema) WithExclusiveMax(value bool) *Schema

+ func (schema *Schema) WithExclusiveMin(value bool) *Schema

+ func (schema *Schema) WithFormat(value string) *Schema

+ func (schema *Schema) WithItems(value *Schema) *Schema

+ func (schema *Schema) WithLength(i int64) *Schema

+ func (schema *Schema) WithLengthDecodedBase64(i int64) *Schema

+ func (schema *Schema) WithMax(value float64) *Schema

+ func (schema *Schema) WithMaxItems(i int64) *Schema

+ func (schema *Schema) WithMaxLength(i int64) *Schema

+ func (schema *Schema) WithMaxLengthDecodedBase64(i int64) *Schema

+ func (schema *Schema) WithMaxProperties(i int64) *Schema

+ func (schema *Schema) WithMin(value float64) *Schema

+ func (schema *Schema) WithMinItems(i int64) *Schema

+ func (schema *Schema) WithMinLength(i int64) *Schema

+ func (schema *Schema) WithMinLengthDecodedBase64(i int64) *Schema

+ func (schema *Schema) WithMinProperties(i int64) *Schema

+ func (schema *Schema) WithNullable() *Schema

+ func (schema *Schema) WithPattern(pattern string) *Schema

+ func (schema *Schema) WithProperties(properties map[string]*Schema) *Schema

+ func (schema *Schema) WithProperty(name string, propertySchema *Schema) *Schema

+ func (schema *Schema) WithPropertyRef(name string, ref *SchemaRef) *Schema

+ func (schema *Schema) WithUniqueItems(unique bool) *Schema

+ type SchemaError struct

+ Origin error

+ Reason string

+ Schema *Schema

+ SchemaField string

+ Value interface{}

+ func (err *SchemaError) Error() string

+ func (err *SchemaError) JSONPointer() []string

+ type SchemaRef struct

+ Ref string

+ Value *Schema

+ func NewSchemaRef(ref string, value *Schema) *SchemaRef

+ func (value *SchemaRef) MarshalJSON() ([]byte, error)

+ func (value *SchemaRef) UnmarshalJSON(data []byte) error

+ func (value *SchemaRef) Validate(c context.Context) error

+ type SecurityRequirement map[string][]string

+ func NewSecurityRequirement() SecurityRequirement

+ func (security SecurityRequirement) Authenticate(provider string, scopes ...string) SecurityRequirement

+ func (security SecurityRequirement) Validate(c context.Context) error

+ type SecurityRequirements []SecurityRequirement

+ func NewSecurityRequirements() *SecurityRequirements

+ func (srs *SecurityRequirements) With(securityRequirement SecurityRequirement) *SecurityRequirements

+ func (srs SecurityRequirements) Validate(c context.Context) error

+ type SecurityScheme struct

+ BearerFormat string

+ Description string

+ Flows *OAuthFlows

+ In string

+ Name string

+ Scheme string

+ Type string

+ func NewCSRFSecurityScheme() *SecurityScheme

+ func NewJWTSecurityScheme() *SecurityScheme

+ func NewSecurityScheme() *SecurityScheme

+ func (ss *SecurityScheme) MarshalJSON() ([]byte, error)

+ func (ss *SecurityScheme) UnmarshalJSON(data []byte) error

+ func (ss *SecurityScheme) Validate(c context.Context) error

+ func (ss *SecurityScheme) WithBearerFormat(value string) *SecurityScheme

+ func (ss *SecurityScheme) WithDescription(value string) *SecurityScheme

+ func (ss *SecurityScheme) WithIn(value string) *SecurityScheme

+ func (ss *SecurityScheme) WithName(value string) *SecurityScheme

+ func (ss *SecurityScheme) WithScheme(value string) *SecurityScheme

+ func (ss *SecurityScheme) WithType(value string) *SecurityScheme

+ type SecuritySchemeRef struct

+ Ref string

+ Value *SecurityScheme

+ func (value *SecuritySchemeRef) MarshalJSON() ([]byte, error)

+ func (value *SecuritySchemeRef) UnmarshalJSON(data []byte) error

+ func (value *SecuritySchemeRef) Validate(c context.Context) error

+ type Server struct

+ Description string

+ URL string

+ Variables map[string]*ServerVariable

+ func (server *Server) Validate(c context.Context) (err error)

+ func (server Server) MatchRawURL(input string) ([]string, string, bool)

+ func (server Server) ParameterNames() ([]string, error)

+ type ServerVariable struct

+ Default interface{}

+ Description string

+ Enum []interface{}

+ func (serverVariable *ServerVariable) Validate(c context.Context) error

+ type Servers []*Server

+ func (servers Servers) MatchURL(parsedURL *url.URL) (*Server, []string, string)

+ func (servers Servers) Validate(c context.Context) error

+ type Swagger struct

+ Components Components

+ ExternalDocs *ExternalDocs

+ Info Info

+ OpenAPI string

+ Paths Paths

+ Security SecurityRequirements

+ Servers Servers

+ func (swagger *Swagger) AddOperation(path string, method string, operation *Operation)

+ func (swagger *Swagger) AddServer(server *Server)

+ func (swagger *Swagger) MarshalJSON() ([]byte, error)

+ func (swagger *Swagger) UnmarshalJSON(data []byte) error

+ func (swagger *Swagger) Validate(c context.Context) error

+ type SwaggerLoader struct

+ Context context.Context

+ IsExternalRefsAllowed bool

+ LoadSwaggerFromURIFunc func(loader *SwaggerLoader, url *url.URL) (*Swagger, error)

+ func NewSwaggerLoader() *SwaggerLoader

+ func (swaggerLoader *SwaggerLoader) LoadSwaggerFromData(data []byte) (*Swagger, error)

+ func (swaggerLoader *SwaggerLoader) LoadSwaggerFromFile(path string) (*Swagger, error)

+ func (swaggerLoader *SwaggerLoader) LoadSwaggerFromURI(location *url.URL) (*Swagger, error)

+ func (swaggerLoader *SwaggerLoader) LoadSwaggerFromYAMLData(data []byte) (*Swagger, error)

+ func (swaggerLoader *SwaggerLoader) ResolveRefsIn(swagger *Swagger) (err error)

+ type Tag struct

+ Description string

+ ExternalDocs *ExternalDocs

+ Name string

+ type Tags []*Tag

+ func (tags Tags) Get(name string) *Tag

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL