Help us shape the future of Go! Take the 2026 Go Developer Survey

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

turnstile

package module

Go to main page

Versions in this module

v1

v1.0.0

Sep 18, 2026

Changes in this version

+ const DefaultEndpoint

+ const DefaultTimeout

+ var ErrInvalidStatus = errors.New("turnstile: verification returned non-200 status")

+ var ErrMissingSecret = errors.New("turnstile: secret key is required")

+ var ErrMissingToken = errors.New("turnstile: response token is required")

+ var ErrTokenTooLarge = errors.New("turnstile: token is too large")

+ type Client struct

+ func New(secret string, opts ...Option) *Client

+ func (c *Client) Verify(ctx context.Context, token string, params ...VerifyParams) (*Result, error)

+ type Option func(*Client)

+ func WithEndpoint(endpoint string) Option

+ func WithHTTPClient(client *http.Client) Option

+ func WithTimeout(timeout time.Duration) Option

+ type Result struct

+ Action string

+ CData string

+ ChallengeTS time.Time

+ ErrorCodes []string

+ Hostname string

+ Success bool

+ func Verify(ctx context.Context, secret, token string, params ...VerifyParams) (*Result, error)

+ type VerifyParams struct

+ IdempotencyKey string

+ RemoteIP string