Documentation
¶
Overview ¶
Package openapi provides primitives to interact with the openapi HTTP API.
Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.3.0 DO NOT EDIT.
Package openapi provides primitives to interact with the openapi HTTP API.
Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.3.0 DO NOT EDIT.
Package openapi provides primitives to interact with the openapi HTTP API.
Code generated by github.com/oapi-codegen/oapi-codegen/v2 version v2.3.0 DO NOT EDIT.
Index ¶
- type ApiKeyAsBasicOpts
- type ApiKeyAsBasicOptsFieldUsed
- type ApiKeyOpts
- type ApiKeyOptsAttachmentType
- type ApiKeyOptsHeader
- type ApiKeyOptsQuery
- type ApiProblem
- type AuthType
- type Backfill
- type BasicAuthOpts
- type BulkWriteSupport
- type CatalogType
- type CatalogWrapper
- type DefaultPeriod
- type HydratedIntegration
- type HydratedIntegrationField
- func (t HydratedIntegrationField) AsHydratedIntegrationFieldExistent() (HydratedIntegrationFieldExistent, error)
- func (t HydratedIntegrationField) AsIntegrationFieldMapping() (IntegrationFieldMapping, error)
- func (t *HydratedIntegrationField) FromHydratedIntegrationFieldExistent(v HydratedIntegrationFieldExistent) error
- func (t *HydratedIntegrationField) FromIntegrationFieldMapping(v IntegrationFieldMapping) error
- func (t HydratedIntegrationField) MarshalJSON() ([]byte, error)
- func (t *HydratedIntegrationField) MergeHydratedIntegrationFieldExistent(v HydratedIntegrationFieldExistent) error
- func (t *HydratedIntegrationField) MergeIntegrationFieldMapping(v IntegrationFieldMapping) error
- func (t *HydratedIntegrationField) UnmarshalJSON(b []byte) error
- type HydratedIntegrationFieldExistent
- type HydratedIntegrationObject
- type HydratedIntegrationProxy
- type HydratedIntegrationRead
- type HydratedIntegrationWrite
- type HydratedIntegrationWriteObject
- type InputValidationIssue
- type InputValidationProblem
- type InputValidationProblemResponse
- type Integration
- type IntegrationField
- func (t IntegrationField) AsIntegrationFieldExistent() (IntegrationFieldExistent, error)
- func (t IntegrationField) AsIntegrationFieldMapping() (IntegrationFieldMapping, error)
- func (t *IntegrationField) FromIntegrationFieldExistent(v IntegrationFieldExistent) error
- func (t *IntegrationField) FromIntegrationFieldMapping(v IntegrationFieldMapping) error
- func (t IntegrationField) MarshalJSON() ([]byte, error)
- func (t *IntegrationField) MergeIntegrationFieldExistent(v IntegrationFieldExistent) error
- func (t *IntegrationField) MergeIntegrationFieldMapping(v IntegrationFieldMapping) error
- func (t *IntegrationField) UnmarshalJSON(b []byte) error
- type IntegrationFieldExistent
- type IntegrationFieldMapping
- type IntegrationObject
- type IntegrationProxy
- type IntegrationRead
- type IntegrationWrite
- type IntegrationWriteObject
- type Manifest
- type Media
- type MediaTypeDarkMode
- type MediaTypeRegular
- type Oauth2Opts
- type Oauth2OptsGrantType
- type OptionalFieldsAutoOption
- type Problem
- type ProblemResponse
- type Provider
- type ProviderInfo
- type ProviderOpts
- type Support
- type TokenMetadataFields
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ApiKeyAsBasicOpts ¶ added in v1.0.4
type ApiKeyAsBasicOpts struct {
// FieldUsed whether the API key should be used as the username or password.
FieldUsed ApiKeyAsBasicOptsFieldUsed `json:"fieldUsed,omitempty"`
// KeyFormat How to transform the API key in to a basic auth user:pass string. The %s is replaced with the API key value.
KeyFormat string `json:"keyFormat,omitempty"`
}
ApiKeyAsBasicOpts when this object is present, it means that this provider uses Basic Auth to actually collect an API key
type ApiKeyAsBasicOptsFieldUsed ¶ added in v1.0.4
type ApiKeyAsBasicOptsFieldUsed string
ApiKeyAsBasicOptsFieldUsed whether the API key should be used as the username or password.
const ( PasswordField ApiKeyAsBasicOptsFieldUsed = "password" UsernameField ApiKeyAsBasicOptsFieldUsed = "username" )
Defines values for ApiKeyAsBasicOptsFieldUsed.
type ApiKeyOpts ¶ added in v1.0.4
type ApiKeyOpts struct {
// AttachmentType How the API key should be attached to requests.
AttachmentType ApiKeyOptsAttachmentType `json:"attachmentType" validate:"required"`
// DocsURL URL with more information about how to get or use an API key.
DocsURL string `json:"docsURL,omitempty"`
// Header Configuration for API key in header. Must be provided if type is in-header.
Header *ApiKeyOptsHeader `json:"header,omitempty"`
// Query Configuration for API key in query parameter. Must be provided if type is in-query.
Query *ApiKeyOptsQuery `json:"query,omitempty"`
}
ApiKeyOpts Configuration for API key. Must be provided if authType is apiKey.
type ApiKeyOptsAttachmentType ¶ added in v1.0.4
type ApiKeyOptsAttachmentType string
ApiKeyOptsAttachmentType How the API key should be attached to requests.
const ( Header ApiKeyOptsAttachmentType = "header" Query ApiKeyOptsAttachmentType = "query" )
Defines values for ApiKeyOptsAttachmentType.
type ApiKeyOptsHeader ¶ added in v1.0.4
type ApiKeyOptsHeader struct {
// Name The name of the header to be used for the API key.
Name string `json:"name"`
// ValuePrefix The prefix to be added to the API key value when it is sent in the header.
ValuePrefix string `json:"valuePrefix,omitempty"`
}
ApiKeyOptsHeader Configuration for API key in header. Must be provided if type is in-header.
type ApiKeyOptsQuery ¶ added in v1.0.4
type ApiKeyOptsQuery struct {
// Name The name of the query parameter to be used for the API key.
Name string `json:"name"`
}
ApiKeyOptsQuery Configuration for API key in query parameter. Must be provided if type is in-query.
type ApiProblem ¶
type ApiProblem = Problem
ApiProblem A Problem Details object (RFC 9457).
Additional properties specific to the problem type may be present.
type AuthType ¶ added in v1.0.4
type AuthType string
AuthType The type of authentication required by the provider.
type Backfill ¶ added in v1.0.3
type Backfill struct {
DefaultPeriod DefaultPeriod `json:"defaultPeriod"`
}
Backfill defines model for Backfill.
type BasicAuthOpts ¶ added in v1.0.4
type BasicAuthOpts struct {
// ApiKeyAsBasic If true, the provider uses an API key which then gets encoded as a basic auth user:pass string.
ApiKeyAsBasic bool `json:"apiKeyAsBasic,omitempty"`
// ApiKeyAsBasicOpts when this object is present, it means that this provider uses Basic Auth to actually collect an API key
ApiKeyAsBasicOpts *ApiKeyAsBasicOpts `json:"apiKeyAsBasicOpts,omitempty"`
// DocsURL URL with more information about how to get or use an API key.
DocsURL string `json:"docsURL,omitempty"`
}
BasicAuthOpts Configuration for Basic Auth. Optional.
type BulkWriteSupport ¶ added in v1.0.4
type BulkWriteSupport struct {
Delete bool `json:"delete"`
Insert bool `json:"insert"`
Update bool `json:"update"`
Upsert bool `json:"upsert"`
}
BulkWriteSupport defines model for BulkWriteSupport.
type CatalogType ¶ added in v1.0.4
type CatalogType map[string]ProviderInfo
CatalogType defines model for CatalogType.
type CatalogWrapper ¶ added in v1.0.4
type CatalogWrapper struct {
Catalog CatalogType `json:"catalog"`
// Timestamp An RFC3339 formatted timestamp of when the catalog was generated.
Timestamp string `json:"timestamp" validate:"required"`
}
CatalogWrapper defines model for CatalogWrapper.
type DefaultPeriod ¶ added in v1.0.3
type DefaultPeriod struct {
// Days Number of days in past to backfill from. 0 is no backfill. e.g) if 10, then backfill last 10 days of data. Required if fullHistory is not set.
Days *int `json:"days,omitempty" validate:"required_without=FullHistory,omitempty,min=0"`
// FullHistory If true, backfill all history. Required if days is not set.
FullHistory *bool `json:"fullHistory,omitempty" validate:"required_without=Days"`
}
DefaultPeriod defines model for DefaultPeriod.
type HydratedIntegration ¶
type HydratedIntegration struct {
DisplayName *string `json:"displayName,omitempty"`
Name string `json:"name"`
Provider string `json:"provider"`
Proxy *HydratedIntegrationProxy `json:"proxy,omitempty"`
Read *HydratedIntegrationRead `json:"read,omitempty"`
Write *HydratedIntegrationWrite `json:"write,omitempty"`
}
HydratedIntegration defines model for HydratedIntegration.
type HydratedIntegrationField ¶
type HydratedIntegrationField struct {
// contains filtered or unexported fields
}
HydratedIntegrationField defines model for HydratedIntegrationField.
func (HydratedIntegrationField) AsHydratedIntegrationFieldExistent ¶
func (t HydratedIntegrationField) AsHydratedIntegrationFieldExistent() (HydratedIntegrationFieldExistent, error)
AsHydratedIntegrationFieldExistent returns the union data inside the HydratedIntegrationField as a HydratedIntegrationFieldExistent
func (HydratedIntegrationField) AsIntegrationFieldMapping ¶
func (t HydratedIntegrationField) AsIntegrationFieldMapping() (IntegrationFieldMapping, error)
AsIntegrationFieldMapping returns the union data inside the HydratedIntegrationField as a IntegrationFieldMapping
func (*HydratedIntegrationField) FromHydratedIntegrationFieldExistent ¶
func (t *HydratedIntegrationField) FromHydratedIntegrationFieldExistent(v HydratedIntegrationFieldExistent) error
FromHydratedIntegrationFieldExistent overwrites any union data inside the HydratedIntegrationField as the provided HydratedIntegrationFieldExistent
func (*HydratedIntegrationField) FromIntegrationFieldMapping ¶
func (t *HydratedIntegrationField) FromIntegrationFieldMapping(v IntegrationFieldMapping) error
FromIntegrationFieldMapping overwrites any union data inside the HydratedIntegrationField as the provided IntegrationFieldMapping
func (HydratedIntegrationField) MarshalJSON ¶
func (t HydratedIntegrationField) MarshalJSON() ([]byte, error)
func (*HydratedIntegrationField) MergeHydratedIntegrationFieldExistent ¶
func (t *HydratedIntegrationField) MergeHydratedIntegrationFieldExistent(v HydratedIntegrationFieldExistent) error
MergeHydratedIntegrationFieldExistent performs a merge with any union data inside the HydratedIntegrationField, using the provided HydratedIntegrationFieldExistent
func (*HydratedIntegrationField) MergeIntegrationFieldMapping ¶
func (t *HydratedIntegrationField) MergeIntegrationFieldMapping(v IntegrationFieldMapping) error
MergeIntegrationFieldMapping performs a merge with any union data inside the HydratedIntegrationField, using the provided IntegrationFieldMapping
func (*HydratedIntegrationField) UnmarshalJSON ¶
func (t *HydratedIntegrationField) UnmarshalJSON(b []byte) error
type HydratedIntegrationFieldExistent ¶
type HydratedIntegrationFieldExistent struct {
DisplayName string `json:"displayName"`
FieldName string `json:"fieldName"`
}
HydratedIntegrationFieldExistent defines model for HydratedIntegrationFieldExistent.
type HydratedIntegrationObject ¶
type HydratedIntegrationObject struct {
// AllFields This is a list of all fields on the object for a particular SaaS instance. This is used to populate the UI during configuration.
AllFields *[]HydratedIntegrationField `json:"allFields,omitempty"`
Backfill *Backfill `json:"backfill,omitempty"`
Destination string `json:"destination"`
DisplayName string `json:"displayName"`
ObjectName string `json:"objectName"`
OptionalFields *[]HydratedIntegrationField `json:"optionalFields,omitempty"`
OptionalFieldsAuto *OptionalFieldsAutoOption `json:"optionalFieldsAuto,omitempty"`
RequiredFields *[]HydratedIntegrationField `json:"requiredFields,omitempty"`
Schedule string `json:"schedule"`
}
HydratedIntegrationObject defines model for HydratedIntegrationObject.
type HydratedIntegrationProxy ¶
type HydratedIntegrationProxy struct {
Enabled *bool `json:"enabled,omitempty"`
}
HydratedIntegrationProxy defines model for HydratedIntegrationProxy.
type HydratedIntegrationRead ¶
type HydratedIntegrationRead struct {
Objects *[]HydratedIntegrationObject `json:"objects,omitempty"`
}
HydratedIntegrationRead defines model for HydratedIntegrationRead.
type HydratedIntegrationWrite ¶
type HydratedIntegrationWrite struct {
Objects *[]HydratedIntegrationWriteObject `json:"objects,omitempty"`
}
HydratedIntegrationWrite defines model for HydratedIntegrationWrite.
type HydratedIntegrationWriteObject ¶
type HydratedIntegrationWriteObject struct {
DisplayName string `json:"displayName"`
ObjectName string `json:"objectName"`
}
HydratedIntegrationWriteObject defines model for HydratedIntegrationWriteObject.
type InputValidationIssue ¶
type InputValidationIssue = ApiProblem
InputValidationIssue defines model for InputValidationIssue.
type InputValidationProblem ¶
type InputValidationProblem = ApiProblem
InputValidationProblem defines model for InputValidationProblem.
type InputValidationProblemResponse ¶
type InputValidationProblemResponse = InputValidationProblem
InputValidationProblemResponse defines model for InputValidationProblemResponse.
type Integration ¶
type Integration struct {
DisplayName *string `json:"displayName,omitempty"`
Name string `json:"name"`
Provider string `json:"provider"`
Proxy *IntegrationProxy `json:"proxy,omitempty"`
Read *IntegrationRead `json:"read,omitempty"`
Write *IntegrationWrite `json:"write,omitempty"`
}
Integration defines model for Integration.
type IntegrationField ¶
type IntegrationField struct {
// contains filtered or unexported fields
}
IntegrationField defines model for IntegrationField.
func (IntegrationField) AsIntegrationFieldExistent ¶
func (t IntegrationField) AsIntegrationFieldExistent() (IntegrationFieldExistent, error)
AsIntegrationFieldExistent returns the union data inside the IntegrationField as a IntegrationFieldExistent
func (IntegrationField) AsIntegrationFieldMapping ¶
func (t IntegrationField) AsIntegrationFieldMapping() (IntegrationFieldMapping, error)
AsIntegrationFieldMapping returns the union data inside the IntegrationField as a IntegrationFieldMapping
func (*IntegrationField) FromIntegrationFieldExistent ¶
func (t *IntegrationField) FromIntegrationFieldExistent(v IntegrationFieldExistent) error
FromIntegrationFieldExistent overwrites any union data inside the IntegrationField as the provided IntegrationFieldExistent
func (*IntegrationField) FromIntegrationFieldMapping ¶
func (t *IntegrationField) FromIntegrationFieldMapping(v IntegrationFieldMapping) error
FromIntegrationFieldMapping overwrites any union data inside the IntegrationField as the provided IntegrationFieldMapping
func (IntegrationField) MarshalJSON ¶
func (t IntegrationField) MarshalJSON() ([]byte, error)
func (*IntegrationField) MergeIntegrationFieldExistent ¶
func (t *IntegrationField) MergeIntegrationFieldExistent(v IntegrationFieldExistent) error
MergeIntegrationFieldExistent performs a merge with any union data inside the IntegrationField, using the provided IntegrationFieldExistent
func (*IntegrationField) MergeIntegrationFieldMapping ¶
func (t *IntegrationField) MergeIntegrationFieldMapping(v IntegrationFieldMapping) error
MergeIntegrationFieldMapping performs a merge with any union data inside the IntegrationField, using the provided IntegrationFieldMapping
func (*IntegrationField) UnmarshalJSON ¶
func (t *IntegrationField) UnmarshalJSON(b []byte) error
type IntegrationFieldExistent ¶
type IntegrationFieldExistent struct {
FieldName string `json:"fieldName"`
}
IntegrationFieldExistent defines model for IntegrationFieldExistent.
type IntegrationFieldMapping ¶
type IntegrationFieldMapping struct {
Default *string `json:"default,omitempty"`
MapToDisplayName *string `json:"mapToDisplayName,omitempty"`
MapToName string `json:"mapToName"`
Prompt *string `json:"prompt,omitempty"`
}
IntegrationFieldMapping defines model for IntegrationFieldMapping.
type IntegrationObject ¶
type IntegrationObject struct {
Backfill *Backfill `json:"backfill,omitempty"`
Destination string `json:"destination"`
ObjectName string `json:"objectName"`
OptionalFields *[]IntegrationField `json:"optionalFields,omitempty"`
OptionalFieldsAuto *OptionalFieldsAutoOption `json:"optionalFieldsAuto,omitempty"`
RequiredFields *[]IntegrationField `json:"requiredFields,omitempty"`
Schedule string `json:"schedule"`
}
IntegrationObject defines model for IntegrationObject.
type IntegrationProxy ¶
type IntegrationProxy struct {
Enabled *bool `json:"enabled,omitempty"`
}
IntegrationProxy defines model for IntegrationProxy.
type IntegrationRead ¶
type IntegrationRead struct {
Objects *[]IntegrationObject `json:"objects,omitempty"`
}
IntegrationRead defines model for IntegrationRead.
type IntegrationWrite ¶
type IntegrationWrite struct {
Objects *[]IntegrationWriteObject `json:"objects,omitempty"`
}
IntegrationWrite defines model for IntegrationWrite.
type IntegrationWriteObject ¶
type IntegrationWriteObject struct {
ObjectName string `json:"objectName"`
}
IntegrationWriteObject defines model for IntegrationWriteObject.
type Manifest ¶
type Manifest struct {
Integrations []Integration `json:"integrations"`
// SpecVersion The version of the manifest spec that this file conforms to.
SpecVersion string `json:"specVersion"`
}
Manifest This is the schema of the manifest file that is used to define the integrations of the project.
type Media ¶ added in v1.0.4
type Media struct {
// DarkMode Media to be used in dark mode.
DarkMode *MediaTypeDarkMode `json:"darkMode,omitempty"`
// Regular Media for light/regular mode.
Regular *MediaTypeRegular `json:"regular,omitempty"`
}
Media defines model for Media.
type MediaTypeDarkMode ¶ added in v1.0.4
type MediaTypeDarkMode struct {
// IconURL URL to the icon for the provider that is to be used in dark mode.
IconURL string `json:"iconURL,omitempty"`
// LogoURL URL to the logo for the provider that is to be used in dark mode.
LogoURL string `json:"logoURL,omitempty"`
}
MediaTypeDarkMode Media to be used in dark mode.
type MediaTypeRegular ¶ added in v1.0.4
type MediaTypeRegular struct {
// IconURL URL to the icon for the provider.
IconURL string `json:"iconURL,omitempty"`
// LogoURL URL to the logo for the provider.
LogoURL string `json:"logoURL,omitempty"`
}
MediaTypeRegular Media for light/regular mode.
type Oauth2Opts ¶ added in v1.0.4
type Oauth2Opts struct {
// Audience A list of URLs that represent the audience for the token, which is needed for some client credential grant flows.
Audience []string `json:"audience,omitempty"`
// AuthURL The authorization URL.
AuthURL string `json:"authURL,omitempty"`
AuthURLParams map[string]string `json:"authURLParams,omitempty"`
// DocsURL URL with more information about where to retrieve Client ID and Client Secret, etc.
DocsURL string `json:"docsURL,omitempty"`
// ExplicitScopesRequired Whether scopes are required to be known ahead of the OAuth flow.
ExplicitScopesRequired bool `json:"explicitScopesRequired"`
// ExplicitWorkspaceRequired Whether the workspace is required to be known ahead of the OAuth flow.
ExplicitWorkspaceRequired bool `json:"explicitWorkspaceRequired"`
GrantType Oauth2OptsGrantType `json:"grantType"`
// TokenMetadataFields Fields to be used to extract token metadata from the token response.
TokenMetadataFields TokenMetadataFields `json:"tokenMetadataFields"`
// TokenURL The token URL.
TokenURL string `json:"tokenURL" validate:"required"`
}
Oauth2Opts Configuration for OAuth2.0. Must be provided if authType is oauth2.
type Oauth2OptsGrantType ¶ added in v1.0.4
type Oauth2OptsGrantType string
Oauth2OptsGrantType defines model for Oauth2Opts.GrantType.
const ( AuthorizationCode Oauth2OptsGrantType = "authorizationCode" ClientCredentials Oauth2OptsGrantType = "clientCredentials" PKCE Oauth2OptsGrantType = "PKCE" Password Oauth2OptsGrantType = "password" )
Defines values for Oauth2OptsGrantType.
type OptionalFieldsAutoOption ¶
type OptionalFieldsAutoOption string
OptionalFieldsAutoOption defines model for OptionalFieldsAutoOption.
const (
All OptionalFieldsAutoOption = "all"
)
Defines values for OptionalFieldsAutoOption.
type Problem ¶
type Problem struct {
// Detail A human-readable explanation specific to this occurrence of the problem
Detail *string `json:"detail,omitempty"`
// Href An absolute URI that, when dereferenced, provides human-readable documentation for the problem type (e.g. using HTML).
Href *string `json:"href,omitempty"`
// Instance An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
Instance *string `json:"instance,omitempty"`
// Status The HTTP status code generated by the origin server for this occurrence of the problem.
Status *int32 `json:"status,omitempty"`
// Title A short summary of the problem type. Written in English and readable for engineers (usually not suited for non technical stakeholders and not localized).
Title *string `json:"title,omitempty"`
// Type An absolute URI that identifies the problem type
Type *string `json:"type,omitempty"`
}
Problem A Problem Details object (RFC 9457).
Additional properties specific to the problem type may be present.
type ProblemResponse ¶
type ProblemResponse = Problem
ProblemResponse A Problem Details object (RFC 9457).
Additional properties specific to the problem type may be present.
type ProviderInfo ¶ added in v1.0.4
type ProviderInfo struct {
// ApiKeyOpts Configuration for API key. Must be provided if authType is apiKey.
ApiKeyOpts *ApiKeyOpts `json:"apiKeyOpts,omitempty"`
// AuthType The type of authentication required by the provider.
AuthType AuthType `json:"authType" validate:"required"`
// BaseURL The base URL for making API requests.
BaseURL string `json:"baseURL" validate:"required"`
// BasicOpts Configuration for Basic Auth. Optional.
BasicOpts *BasicAuthOpts `json:"basicOpts,omitempty"`
// DisplayName The display name of the provider, if omitted, defaults to provider name.
DisplayName string `json:"displayName,omitempty"`
Media *Media `json:"media,omitempty"`
Name string `json:"name"`
// Oauth2Opts Configuration for OAuth2.0. Must be provided if authType is oauth2.
Oauth2Opts *Oauth2Opts `json:"oauth2Opts,omitempty"`
// PostAuthInfoNeeded If true, we require additional information after auth to start making requests.
PostAuthInfoNeeded bool `json:"postAuthInfoNeeded,omitempty"`
// ProviderOpts Additional provider-specific metadata.
ProviderOpts ProviderOpts `json:"providerOpts"`
// Support The supported features for the provider.
Support Support `json:"support" validate:"required"`
}
ProviderInfo defines model for ProviderInfo.
type ProviderOpts ¶ added in v1.0.4
ProviderOpts Additional provider-specific metadata.
type Support ¶ added in v1.0.4
type Support struct {
BulkWrite BulkWriteSupport `json:"bulkWrite" validate:"required"`
Proxy bool `json:"proxy"`
Read bool `json:"read"`
Subscribe bool `json:"subscribe"`
Write bool `json:"write"`
}
Support The supported features for the provider.
type TokenMetadataFields ¶ added in v1.0.4
type TokenMetadataFields struct {
ConsumerRefField string `json:"consumerRefField,omitempty"`
ScopesField string `json:"scopesField,omitempty"`
WorkspaceRefField string `json:"workspaceRefField,omitempty"`
}
TokenMetadataFields Fields to be used to extract token metadata from the token response.