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

webservice

package module

Go to main page

Versions in this module

v0

v0.9.3

Jun 11, 2026

v0.9.2

Jun 11, 2026

Changes in this version

type APIBuilder

+ func (b *APIBuilder) AddFilesystemPath(urlPath string, filesystemPath string) *echo.Echo

+ func (b *APIBuilder) EmbedFS(path string, webFs embed.FS) *echo.Echo

+ func (b *APIBuilder) RunHttps(listenPort int, certFile interface{}, keyFile interface{}) error

v0.9.1

Jun 6, 2026

Changes in this version

+ const ContextKey_Correlation

+ const ContextKey_EmailVerified

+ const ContextKey_FamilyName

+ const ContextKey_GivenName

+ const ContextKey_Roles

+ const ContextKey_SourceIP

+ const ContextKey_UserEmail

+ const ContextKey_UserID

+ func AuthWithValidator(_ *redis.Client, basePath string, spec *openapi3.T, ...) echo.MiddlewareFunc

+ func CorrelationContextEnricher(baseLogger *zerolog.Logger) echo.MiddlewareFunc

+ func RateLimiter(rdb *redis.Client, maxRequests int, duration time.Duration) echo.MiddlewareFunc

+ func RequestLogger(baseLogger *zerolog.Logger) echo.MiddlewareFunc

+ func RoleValidator(spec *openapi3.T) echo.MiddlewareFunc

+ func SetCorrelationID() echo.MiddlewareFunc

+ func SourceIP() echo.MiddlewareFunc

+ func TracingMiddleware(next echo.HandlerFunc) echo.HandlerFunc

+ type APIBuilder struct

+ func NewWebServer(appName string) *APIBuilder

+ func (b *APIBuilder) AddServerIf(condition bool, server string) *APIBuilder

+ func (b *APIBuilder) AllowHeaders(headers ...string) *APIBuilder

+ func (b *APIBuilder) AllowMethods(methods ...string) *APIBuilder

+ func (b *APIBuilder) AllowOrigins(origins ...string) *APIBuilder

+ func (b *APIBuilder) ClearServers() *APIBuilder

+ func (b *APIBuilder) CustomAPITokenValidation(f CustomApiAuthentication) *APIBuilder

+ func (b *APIBuilder) CustomGET(path string, handler echo.HandlerFunc) *APIBuilder

+ func (b *APIBuilder) EnablePrometheus(enable bool) *APIBuilder

+ func (b *APIBuilder) EnableSwagger(enable bool) *APIBuilder

+ func (b *APIBuilder) ErrorHandler(f CustomErrorHandler) *APIBuilder

+ func (b *APIBuilder) OnEveryCall(handler echo.MiddlewareFunc) *APIBuilder

+ func (b *APIBuilder) PublicAPI(basePath string, oapiSpecificationPath string, publicName string) *APIBuilder

+ func (b *APIBuilder) RegisterHandler(handler func(*echo.Echo)) *APIBuilder

+ func (b *APIBuilder) Run(listenPort int) error

+ func (b *APIBuilder) RunLocalHttps(listenPort int, certFile interface{}, keyFile interface{}) error

+ func (b *APIBuilder) SetApplicationName(appName string) *APIBuilder

+ func (b *APIBuilder) ThrottleRequests(threshold int, window time.Duration) *APIBuilder

+ func (b *APIBuilder) UseOpenAPISpecs(basePath string, oapiSpecificationPath string, publicName string) *APIBuilder

+ func (b *APIBuilder) UseRedisCache(redisClient *redis.Client) *APIBuilder

+ func (b *APIBuilder) WithAuthentication(oidcBaseURL string, loginOIDCBaseURL string) *APIBuilder

+ func (b *APIBuilder) WithLogger(logger zerolog.Logger) *APIBuilder

+ func (b *APIBuilder) WithOpenTelemetry() *APIBuilder

+ func (b *APIBuilder) WithRoleValidation(enable bool) *APIBuilder

+ type APIDescriptor struct

+ Handler interface{}

+ SpecPath string

+ type CustomApiAuthentication func(ctx context.Context, apitoken, sourceIP string) (email string, firstname string, lastname string, valid bool)

+ type CustomErrorHandler func(err error, c echo.Context)

+ type MergePatchBinder struct

+ func (b *MergePatchBinder) Bind(i any, c echo.Context) error

+ type OapiRegisterFunc func(*echo.Echo)

v0.9.0

May 9, 2026