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

httpapi

package

Go to main page

Versions in this module

v0

v0.6.0

Sep 9, 2026

v0.5.0

Sep 8, 2026

Changes in this version

type Principal

+ Scope string

v0.4.0

Aug 26, 2026

Changes in this version

type Principal

+ GroupIDs []string

+ func (p *Principal) InGroup(groupID string) bool

v0.3.0

Aug 21, 2026

v0.2.0

Aug 19, 2026

Changes in this version

+ func ClientIP(r *http.Request) string

+ func Error(w http.ResponseWriter, status int, msg string)

+ func JSON(w http.ResponseWriter, status int, v any)

+ func WithPrincipal(ctx context.Context, p *Principal) context.Context

+ type Principal struct

+ Roles []string

+ UserID string

+ Username string

+ func PrincipalFrom(ctx context.Context) *Principal

+ func (p *Principal) HasRole(role string) bool