Versions in this module Expand all Collapse all v1 v1.28.0 Nov 18, 2026 Changes in this version + const Version + var ErrExternalReferencesDisabled = errors.New("external references are disabled") + func IsSupportedVersion(v string) bool + func Marshal(ctx context.Context, asyncAPI *AsyncAPI, w io.Writer) error + func SupportedMinorVersions() []string + func Walk(ctx context.Context, asyncAPI *AsyncAPI) iter.Seq[WalkItem] + type AsyncAPI struct + AsyncAPI string + Channels *sequencedmap.Map[string, *ReferencedChannel] + Components *Components + DefaultContentType *string + Extensions *extensions.Extensions + ID *string + Info Info + Operations *sequencedmap.Map[string, *ReferencedOperation] + Servers *sequencedmap.Map[string, *ReferencedServer] + func NewAsyncAPI() *AsyncAPI + func Unmarshal(ctx context.Context, doc io.Reader, opts ...Option[UnmarshalOptions]) (*AsyncAPI, []error, error) + func (a *AsyncAPI) GetAsyncAPI() string + func (a *AsyncAPI) GetChannels() *sequencedmap.Map[string, *ReferencedChannel] + func (a *AsyncAPI) GetComponents() *Components + func (a *AsyncAPI) GetDefaultContentType() string + func (a *AsyncAPI) GetExtensions() *extensions.Extensions + func (a *AsyncAPI) GetID() string + func (a *AsyncAPI) GetInfo() *Info + func (a *AsyncAPI) GetOperations() *sequencedmap.Map[string, *ReferencedOperation] + func (a *AsyncAPI) GetResolvedExternalDocs(docs *ExternalDocumentation) *ExternalDocumentation + func (a *AsyncAPI) GetResolvedSchema(schema *jsonschema.SchemaUnion) *ResolvedSchema + func (a *AsyncAPI) GetServers() *sequencedmap.Map[string, *ReferencedServer] + func (a *AsyncAPI) ResolveAllReferences(ctx context.Context, opts ResolveAllOptions) ([]error, error) + func (a *AsyncAPI) Sync(ctx context.Context) error + func (a *AsyncAPI) Validate(ctx context.Context, opts ...validation.Option) []error + type Bindings struct + Extensions *extensions.Extensions + func NewBindings() *Bindings + func (b *Bindings) All() iter.Seq2[string, values.Value] + func (b *Bindings) GetBindingVersion(protocol string) string + func (b *Bindings) GetExtensions() *extensions.Extensions + func (b *Bindings) Len() int + func (b *Bindings) Validate(_ context.Context, opts ...validation.Option) []error + type Channel struct + Address *string + Bindings *ReferencedBindings + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Messages *sequencedmap.Map[string, *ReferencedMessage] + Parameters *sequencedmap.Map[string, *ReferencedParameter] + Servers []*ReferenceObject + Summary *string + Tags []*Tag + Title *string + func (c *Channel) GetAddress() string + func (c *Channel) GetBindings() *ReferencedBindings + func (c *Channel) GetDescription() string + func (c *Channel) GetExtensions() *extensions.Extensions + func (c *Channel) GetExternalDocs() *ExternalDocumentation + func (c *Channel) GetMessages() *sequencedmap.Map[string, *ReferencedMessage] + func (c *Channel) GetParameters() *sequencedmap.Map[string, *ReferencedParameter] + func (c *Channel) GetServers() []*ReferenceObject + func (c *Channel) GetSummary() string + func (c *Channel) GetTags() []*Tag + func (c *Channel) GetTitle() string + func (c *Channel) Validate(ctx context.Context, opts ...validation.Option) []error + type Components struct + ChannelBindings *sequencedmap.Map[string, *ReferencedBindings] + Channels *sequencedmap.Map[string, *ReferencedChannel] + CorrelationIDs *sequencedmap.Map[string, *ReferencedCorrelationID] + Extensions *extensions.Extensions + ExternalDocs *sequencedmap.Map[string, *ExternalDocumentation] + MessageBindings *sequencedmap.Map[string, *ReferencedBindings] + MessageTraits *sequencedmap.Map[string, *ReferencedMessageTrait] + Messages *sequencedmap.Map[string, *ReferencedMessage] + OperationBindings *sequencedmap.Map[string, *ReferencedBindings] + OperationTraits *sequencedmap.Map[string, *ReferencedOperationTrait] + Operations *sequencedmap.Map[string, *ReferencedOperation] + Parameters *sequencedmap.Map[string, *ReferencedParameter] + Replies *sequencedmap.Map[string, *ReferencedOperationReply] + ReplyAddresses *sequencedmap.Map[string, *ReferencedOperationReplyAddress] + Schemas *sequencedmap.Map[string, *jsonschema.SchemaUnion] + SecuritySchemes *sequencedmap.Map[string, *ReferencedSecurityScheme] + ServerBindings *sequencedmap.Map[string, *ReferencedBindings] + ServerVariables *sequencedmap.Map[string, *ReferencedServerVariable] + Servers *sequencedmap.Map[string, *ReferencedServer] + Tags *sequencedmap.Map[string, *Tag] + func (c *Components) GetChannelBindings() *sequencedmap.Map[string, *ReferencedBindings] + func (c *Components) GetChannels() *sequencedmap.Map[string, *ReferencedChannel] + func (c *Components) GetCorrelationIDs() *sequencedmap.Map[string, *ReferencedCorrelationID] + func (c *Components) GetExtensions() *extensions.Extensions + func (c *Components) GetExternalDocs() *sequencedmap.Map[string, *ExternalDocumentation] + func (c *Components) GetMessageBindings() *sequencedmap.Map[string, *ReferencedBindings] + func (c *Components) GetMessageTraits() *sequencedmap.Map[string, *ReferencedMessageTrait] + func (c *Components) GetMessages() *sequencedmap.Map[string, *ReferencedMessage] + func (c *Components) GetOperationBindings() *sequencedmap.Map[string, *ReferencedBindings] + func (c *Components) GetOperationTraits() *sequencedmap.Map[string, *ReferencedOperationTrait] + func (c *Components) GetOperations() *sequencedmap.Map[string, *ReferencedOperation] + func (c *Components) GetParameters() *sequencedmap.Map[string, *ReferencedParameter] + func (c *Components) GetReplies() *sequencedmap.Map[string, *ReferencedOperationReply] + func (c *Components) GetReplyAddresses() *sequencedmap.Map[string, *ReferencedOperationReplyAddress] + func (c *Components) GetSchemas() *sequencedmap.Map[string, *jsonschema.SchemaUnion] + func (c *Components) GetSecuritySchemes() *sequencedmap.Map[string, *ReferencedSecurityScheme] + func (c *Components) GetServerBindings() *sequencedmap.Map[string, *ReferencedBindings] + func (c *Components) GetServerVariables() *sequencedmap.Map[string, *ReferencedServerVariable] + func (c *Components) GetServers() *sequencedmap.Map[string, *ReferencedServer] + func (c *Components) GetTags() *sequencedmap.Map[string, *Tag] + func (c *Components) Validate(ctx context.Context, opts ...validation.Option) []error + type Contact struct + Email *string + Extensions *extensions.Extensions + Name *string + URL *string + func (c *Contact) GetEmail() string + func (c *Contact) GetExtensions() *extensions.Extensions + func (c *Contact) GetName() string + func (c *Contact) GetURL() string + func (c *Contact) Validate(_ context.Context, _ ...validation.Option) []error + type CorrelationID struct + Description *string + Extensions *extensions.Extensions + Location string + func (c *CorrelationID) GetDescription() string + func (c *CorrelationID) GetExtensions() *extensions.Extensions + func (c *CorrelationID) GetLocation() string + func (c *CorrelationID) Validate(_ context.Context, _ ...validation.Option) []error + type ExternalDocumentation = jsonschema.ExternalDocumentation + type Info struct + Contact *Contact + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + License *License + Tags []*Tag + TermsOfService *string + Title string + Version string + func (i *Info) GetContact() *Contact + func (i *Info) GetDescription() string + func (i *Info) GetExtensions() *extensions.Extensions + func (i *Info) GetExternalDocs() *ExternalDocumentation + func (i *Info) GetLicense() *License + func (i *Info) GetTags() []*Tag + func (i *Info) GetTermsOfService() string + func (i *Info) GetTitle() string + func (i *Info) GetVersion() string + func (i *Info) Validate(ctx context.Context, opts ...validation.Option) []error + type License struct + Extensions *extensions.Extensions + Name string + URL *string + func (l *License) GetExtensions() *extensions.Extensions + func (l *License) GetName() string + func (l *License) GetURL() string + func (l *License) Validate(_ context.Context, _ ...validation.Option) []error + type LocationContext = walkpkg.LocationContext[MatchFunc] + type Locations = walkpkg.Locations[MatchFunc] + type MatchFunc func(Matcher) error + type Matcher struct + Any func(any) error + AsyncAPI func(*AsyncAPI) error + Bindings func(*Bindings) error + Channel func(*Channel) error + Components func(*Components) error + Contact func(*Contact) error + CorrelationID func(*CorrelationID) error + Extensions func(*extensions.Extensions) error + ExternalDocumentation func(*ExternalDocumentation) error + Info func(*Info) error + License func(*License) error + Message func(*Message) error + MessageExample func(*MessageExample) error + MessageTrait func(*MessageTrait) error + OAuthFlow func(*OAuthFlow) error + OAuthFlows func(*OAuthFlows) error + Operation func(*Operation) error + OperationReply func(*OperationReply) error + OperationReplyAddress func(*OperationReplyAddress) error + OperationTrait func(*OperationTrait) error + Parameter func(*Parameter) error + ReferenceObject func(*ReferenceObject) error + ReferencedBindings func(*ReferencedBindings) error + ReferencedChannel func(*ReferencedChannel) error + ReferencedCorrelationID func(*ReferencedCorrelationID) error + ReferencedMessage func(*ReferencedMessage) error + ReferencedMessageTrait func(*ReferencedMessageTrait) error + ReferencedOperation func(*ReferencedOperation) error + ReferencedOperationReply func(*ReferencedOperationReply) error + ReferencedOperationReplyAddress func(*ReferencedOperationReplyAddress) error + ReferencedOperationTrait func(*ReferencedOperationTrait) error + ReferencedParameter func(*ReferencedParameter) error + ReferencedSecurityScheme func(*ReferencedSecurityScheme) error + ReferencedServer func(*ReferencedServer) error + ReferencedServerVariable func(*ReferencedServerVariable) error + SchemaUnion func(*jsonschema.SchemaUnion) error + SecurityScheme func(*SecurityScheme) error + Server func(*Server) error + ServerVariable func(*ServerVariable) error + Tag func(*Tag) error + type Message struct + Bindings *ReferencedBindings + ContentType *string + CorrelationID *ReferencedCorrelationID + Description *string + Examples []*MessageExample + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Headers *jsonschema.SchemaUnion + Name *string + Payload *jsonschema.SchemaUnion + Summary *string + Tags []*Tag + Title *string + Traits []*ReferencedMessageTrait + func (m *Message) GetBindings() *ReferencedBindings + func (m *Message) GetContentType() string + func (m *Message) GetCorrelationID() *ReferencedCorrelationID + func (m *Message) GetDescription() string + func (m *Message) GetEffective() *Message + func (m *Message) GetExamples() []*MessageExample + func (m *Message) GetExtensions() *extensions.Extensions + func (m *Message) GetExternalDocs() *ExternalDocumentation + func (m *Message) GetHeaders() *jsonschema.SchemaUnion + func (m *Message) GetName() string + func (m *Message) GetPayload() *jsonschema.SchemaUnion + func (m *Message) GetSummary() string + func (m *Message) GetTags() []*Tag + func (m *Message) GetTitle() string + func (m *Message) GetTraitSource(field string) (index int, ok bool) + func (m *Message) GetTraits() []*ReferencedMessageTrait + func (m *Message) Validate(ctx context.Context, opts ...validation.Option) []error + type MessageExample struct + Extensions *extensions.Extensions + Headers values.Value + Name *string + Payload values.Value + Summary *string + func (e *MessageExample) GetExtensions() *extensions.Extensions + func (e *MessageExample) GetHeaders() values.Value + func (e *MessageExample) GetName() string + func (e *MessageExample) GetPayload() values.Value + func (e *MessageExample) GetSummary() string + func (e *MessageExample) Validate(_ context.Context, _ ...validation.Option) []error + type MessageTrait struct + Bindings *ReferencedBindings + ContentType *string + CorrelationID *ReferencedCorrelationID + Description *string + Examples []*MessageExample + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Headers *jsonschema.SchemaUnion + Name *string + Summary *string + Tags []*Tag + Title *string + func (t *MessageTrait) GetBindings() *ReferencedBindings + func (t *MessageTrait) GetContentType() string + func (t *MessageTrait) GetCorrelationID() *ReferencedCorrelationID + func (t *MessageTrait) GetDescription() string + func (t *MessageTrait) GetExamples() []*MessageExample + func (t *MessageTrait) GetExtensions() *extensions.Extensions + func (t *MessageTrait) GetExternalDocs() *ExternalDocumentation + func (t *MessageTrait) GetHeaders() *jsonschema.SchemaUnion + func (t *MessageTrait) GetName() string + func (t *MessageTrait) GetSummary() string + func (t *MessageTrait) GetTags() []*Tag + func (t *MessageTrait) GetTitle() string + func (t *MessageTrait) Validate(ctx context.Context, opts ...validation.Option) []error + type OAuthFlow struct + AuthorizationURL *string + AvailableScopes *sequencedmap.Map[string, string] + Extensions *extensions.Extensions + RefreshURL *string + TokenURL *string + func (f *OAuthFlow) GetAuthorizationURL() string + func (f *OAuthFlow) GetAvailableScopes() *sequencedmap.Map[string, string] + func (f *OAuthFlow) GetExtensions() *extensions.Extensions + func (f *OAuthFlow) GetRefreshURL() string + func (f *OAuthFlow) GetTokenURL() string + func (f *OAuthFlow) Validate(ctx context.Context, opts ...validation.Option) []error + type OAuthFlows struct + AuthorizationCode *OAuthFlow + ClientCredentials *OAuthFlow + Extensions *extensions.Extensions + Implicit *OAuthFlow + Password *OAuthFlow + func (f *OAuthFlows) GetAuthorizationCode() *OAuthFlow + func (f *OAuthFlows) GetClientCredentials() *OAuthFlow + func (f *OAuthFlows) GetExtensions() *extensions.Extensions + func (f *OAuthFlows) GetImplicit() *OAuthFlow + func (f *OAuthFlows) GetPassword() *OAuthFlow + func (f *OAuthFlows) Validate(ctx context.Context, opts ...validation.Option) []error + type Operation struct + Action OperationAction + Bindings *ReferencedBindings + Channel ReferenceObject + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Messages []*ReferenceObject + Reply *ReferencedOperationReply + Security []*ReferencedSecurityScheme + Summary *string + Tags []*Tag + Title *string + Traits []*ReferencedOperationTrait + func (o *Operation) GetAction() OperationAction + func (o *Operation) GetBindings() *ReferencedBindings + func (o *Operation) GetChannel() *ReferenceObject + func (o *Operation) GetDescription() string + func (o *Operation) GetEffective() *Operation + func (o *Operation) GetExtensions() *extensions.Extensions + func (o *Operation) GetExternalDocs() *ExternalDocumentation + func (o *Operation) GetMessages() []*ReferenceObject + func (o *Operation) GetReply() *ReferencedOperationReply + func (o *Operation) GetSecurity() []*ReferencedSecurityScheme + func (o *Operation) GetSummary() string + func (o *Operation) GetTags() []*Tag + func (o *Operation) GetTitle() string + func (o *Operation) GetTraitSource(field string) (index int, ok bool) + func (o *Operation) GetTraits() []*ReferencedOperationTrait + func (o *Operation) Validate(ctx context.Context, opts ...validation.Option) []error + type OperationAction string + const OperationActionReceive + const OperationActionSend + type OperationReply struct + Address *ReferencedOperationReplyAddress + Channel *ReferenceObject + Extensions *extensions.Extensions + Messages []*ReferenceObject + func (r *OperationReply) GetAddress() *ReferencedOperationReplyAddress + func (r *OperationReply) GetChannel() *ReferenceObject + func (r *OperationReply) GetExtensions() *extensions.Extensions + func (r *OperationReply) GetMessages() []*ReferenceObject + func (r *OperationReply) Validate(ctx context.Context, opts ...validation.Option) []error + type OperationReplyAddress struct + Description *string + Extensions *extensions.Extensions + Location string + func (a *OperationReplyAddress) GetDescription() string + func (a *OperationReplyAddress) GetExtensions() *extensions.Extensions + func (a *OperationReplyAddress) GetLocation() string + func (a *OperationReplyAddress) Validate(_ context.Context, _ ...validation.Option) []error + type OperationTrait struct + Bindings *ReferencedBindings + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Reply *ReferencedOperationReply + Security []*ReferencedSecurityScheme + Summary *string + Tags []*Tag + Title *string + func (t *OperationTrait) GetBindings() *ReferencedBindings + func (t *OperationTrait) GetDescription() string + func (t *OperationTrait) GetExtensions() *extensions.Extensions + func (t *OperationTrait) GetExternalDocs() *ExternalDocumentation + func (t *OperationTrait) GetReply() *ReferencedOperationReply + func (t *OperationTrait) GetSecurity() []*ReferencedSecurityScheme + func (t *OperationTrait) GetSummary() string + func (t *OperationTrait) GetTags() []*Tag + func (t *OperationTrait) GetTitle() string + func (t *OperationTrait) Validate(ctx context.Context, opts ...validation.Option) []error + type Option func(o *T) + func WithSkipValidation() Option[UnmarshalOptions] + type Parameter struct + Default *string + Description *string + Enum []string + Examples []string + Extensions *extensions.Extensions + Location *string + func (p *Parameter) GetDefault() string + func (p *Parameter) GetDescription() string + func (p *Parameter) GetEnum() []string + func (p *Parameter) GetExamples() []string + func (p *Parameter) GetExtensions() *extensions.Extensions + func (p *Parameter) GetLocation() string + func (p *Parameter) Validate(_ context.Context, _ ...validation.Option) []error + type Reference struct + Object *T + Reference *references.Reference + func (r *Reference[T, V, C]) GetNavigableNode() (any, error) + func (r *Reference[T, V, C]) GetObject() *T + func (r *Reference[T, V, C]) GetReference() references.Reference + func (r *Reference[T, V, C]) GetResolvedReference() references.Reference + func (r *Reference[T, V, C]) IsReference() bool + func (r *Reference[T, V, C]) IsResolved() bool + func (r *Reference[T, V, C]) Populate(source any) error + func (r *Reference[T, V, C]) Validate(ctx context.Context, opts ...validation.Option) []error + type ReferenceObject struct + Reference references.Reference + func NewReferenceObject(ref references.Reference) *ReferenceObject + func (r *ReferenceObject) GetChannel() *Channel + func (r *ReferenceObject) GetMessage() *Message + func (r *ReferenceObject) GetReference() references.Reference + func (r *ReferenceObject) GetResolvedObject() any + func (r *ReferenceObject) GetResolvedReference() references.Reference + func (r *ReferenceObject) GetServer() *Server + func (r *ReferenceObject) IsResolved() bool + func (r *ReferenceObject) Validate(_ context.Context, _ ...validation.Option) []error + type ReferencedBindings = Reference[Bindings, *Bindings, *core.Bindings] + type ReferencedChannel = Reference[Channel, *Channel, *core.Channel] + type ReferencedCorrelationID = Reference[CorrelationID, *CorrelationID, *core.CorrelationID] + type ReferencedMessage = Reference[Message, *Message, *core.Message] + type ReferencedMessageTrait = Reference[MessageTrait, *MessageTrait, *core.MessageTrait] + type ReferencedOperation = Reference[Operation, *Operation, *core.Operation] + type ReferencedOperationReply = Reference[OperationReply, *OperationReply, *core.OperationReply] + type ReferencedOperationReplyAddress = Reference[OperationReplyAddress, *OperationReplyAddress, *core.OperationReplyAddress] + type ReferencedOperationTrait = Reference[OperationTrait, *OperationTrait, *core.OperationTrait] + type ReferencedParameter = Reference[Parameter, *Parameter, *core.Parameter] + type ReferencedSecurityScheme = Reference[SecurityScheme, *SecurityScheme, *core.SecurityScheme] + type ReferencedServer = Reference[Server, *Server, *core.Server] + type ReferencedServerVariable = Reference[ServerVariable, *ServerVariable, *core.ServerVariable] + type ResolveAllOptions struct + AsyncAPILocation string + DisableExternalRefs bool + HTTPClient system.Client + VirtualFS system.VirtualFS + type ResolvedSchema struct + Raw *yaml.Node + Reference references.Reference + Schema *jsonschema.SchemaUnion + SchemaFormat string + type SecurityScheme struct + BearerFormat *string + Description *string + Extensions *extensions.Extensions + Flows *OAuthFlows + In *string + Name *string + OpenIDConnectURL *string + Scheme *string + Scopes []string + Type SecuritySchemeType + func (s *SecurityScheme) GetBearerFormat() string + func (s *SecurityScheme) GetDescription() string + func (s *SecurityScheme) GetExtensions() *extensions.Extensions + func (s *SecurityScheme) GetFlows() *OAuthFlows + func (s *SecurityScheme) GetIn() string + func (s *SecurityScheme) GetName() string + func (s *SecurityScheme) GetOpenIDConnectURL() string + func (s *SecurityScheme) GetScheme() string + func (s *SecurityScheme) GetScopes() []string + func (s *SecurityScheme) GetType() SecuritySchemeType + func (s *SecurityScheme) Validate(ctx context.Context, opts ...validation.Option) []error + type SecuritySchemeType string + const SecuritySchemeTypeAPIKey + const SecuritySchemeTypeAsymmetricEncryption + const SecuritySchemeTypeGSSAPI + const SecuritySchemeTypeHTTP + const SecuritySchemeTypeHTTPAPIKey + const SecuritySchemeTypeOAuth2 + const SecuritySchemeTypeOpenIDConnect + const SecuritySchemeTypePlain + const SecuritySchemeTypeScramSha256 + const SecuritySchemeTypeScramSha512 + const SecuritySchemeTypeSymmetricEncryption + const SecuritySchemeTypeUserPassword + const SecuritySchemeTypeX509 + type Server struct + Bindings *ReferencedBindings + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Host string + Pathname *string + Protocol string + ProtocolVersion *string + Security []*ReferencedSecurityScheme + Summary *string + Tags []*Tag + Title *string + Variables *sequencedmap.Map[string, *ReferencedServerVariable] + func (s *Server) GetBindings() *ReferencedBindings + func (s *Server) GetDescription() string + func (s *Server) GetExtensions() *extensions.Extensions + func (s *Server) GetExternalDocs() *ExternalDocumentation + func (s *Server) GetHost() string + func (s *Server) GetPathname() string + func (s *Server) GetProtocol() string + func (s *Server) GetProtocolVersion() string + func (s *Server) GetSecurity() []*ReferencedSecurityScheme + func (s *Server) GetSummary() string + func (s *Server) GetTags() []*Tag + func (s *Server) GetTitle() string + func (s *Server) GetVariables() *sequencedmap.Map[string, *ReferencedServerVariable] + func (s *Server) Validate(ctx context.Context, opts ...validation.Option) []error + type ServerVariable struct + Default *string + Description *string + Enum []string + Examples []string + Extensions *extensions.Extensions + func (v *ServerVariable) GetDefault() string + func (v *ServerVariable) GetDescription() string + func (v *ServerVariable) GetEnum() []string + func (v *ServerVariable) GetExamples() []string + func (v *ServerVariable) GetExtensions() *extensions.Extensions + func (v *ServerVariable) Validate(_ context.Context, _ ...validation.Option) []error + type Tag struct + Description *string + Extensions *extensions.Extensions + ExternalDocs *ExternalDocumentation + Name *string + Ref *references.Reference + func (t *Tag) GetDescription() string + func (t *Tag) GetExtensions() *extensions.Extensions + func (t *Tag) GetName() string + func (t *Tag) GetResolved() *Tag + func (t *Tag) IsReference() bool + func (t *Tag) Validate(ctx context.Context, opts ...validation.Option) []error + type UnmarshalOptions struct + type WalkItem struct + AsyncAPI *AsyncAPI + Location Locations + Match MatchFunc