Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

openapi

package

Go to main page

Versions in this module

v1

v1.37.0

Sep 30, 2026

v1.36.0

Sep 18, 2026

Changes in this version

+ func LoadDocFromData(data []byte) (*openapi3.T, error)

+ type FieldError struct

+ Field string

+ Reason string

+ func (e FieldError) String() string

type SchemaManager

+ func NewSchemaManagerFromDoc(doc *openapi3.T) *SchemaManager

type ValidationResult

+ FieldErrors []FieldError

+ Status ValidationStatus

+ type ValidationStatus int

+ const StatusInvalid

+ const StatusNoSchema

+ const StatusUnknown

+ const StatusValid

v1.35.0

Sep 10, 2026

v1.34.0

Sep 2, 2026

Changes in this version

+ const CacheTTL

+ const SchemaURL

+ func ExtractPathFromURL(fullURL string) string

+ func FindOperation(doc *openapi3.T, method, path string) (*openapi3.Operation, error)

+ func GetDoc() (*openapi3.T, error)

+ func GetQueryParamSchema(operation *openapi3.Operation) *openapi3.Schema

+ func GetRequestSchema(operation *openapi3.Operation) *openapi3.SchemaRef

+ type OperationSchema struct

+ Description string

+ IsQueryParamSchema bool

+ Method string

+ OperationID string

+ Path string

+ RequestSchema *openapi3.Schema

+ Summary string

+ func (op *OperationSchema) FormatAsJSON() (string, error)

+ func (op *OperationSchema) FormatAsText() string

+ type SchemaManager struct

+ func NewSchemaManager() (*SchemaManager, error)

+ func (sm *SchemaManager) EnhanceError(err error, method, path string) error

+ func (sm *SchemaManager) GetOperationSchema(method, path string) (*OperationSchema, error)

+ func (sm *SchemaManager) ValidateRequest(method, path string, body []byte) (*ValidationResult, error)

+ type ValidationResult struct

+ Errors []string

+ Valid bool