Documentation ¶
Index ¶
Constants ¶
const Script = "https://hcaptcha.com/1/api.js"
Script is the hCaptcha's javascript source file that should be incldued in the HTML head or body.
Variables ¶
var ( // ResponseContextKey is the default request's context key that response of a hcaptcha request is kept. ResponseContextKey string = "iris.hcaptcha" // DefaultFailureHandler is the default HTTP handler that is fired on hcaptcha failures. // See `Client.FailureHandler`. DefaultFailureHandler = func(ctx context.Context) { ctx.StopWithStatus(http.StatusTooManyRequests) } )
var HTMLForm = `` /* 174-byte string literal not displayed */
HTMLForm is the default HTML form for clients. It's totally optional, use your own code for the best possible result depending on your web application. See `ParseForm` and `RenderForm` for more.
Functions ¶
func New ¶
New accepts a hpcatcha secret key and returns a new hcaptcha HTTP Client.
Instructions at: https://docs.hcaptcha.com/.
See its `Handler` and `SiteVerify` for details.
Types ¶
type Client ¶
type Client struct { // FailureHandler if specified, fired when user does not complete hcaptcha successfully. // Failure and error codes information are kept as `Response` type // at the Request's Context key of "hcaptcha". // // Defaults to a handler that writes a status code of 429 (Too Many Requests) // and without additional information. FailureHandler context.Handler // contains filtered or unexported fields }
Client represents the hcaptcha client.
func (*Client) Handler ¶
Handler is the HTTP route middleware featured hcaptcha validation. It calls the `SiteVerify` method and fires the "next" when user completed the hcaptcha successfully,
otherwise it calls the Client's `FailureHandler`.
The hcaptcha's `Response` (which contains any `ErrorCodes`) is saved on the Request's Context (see `GetResponseFromContext`).
type Option ¶
type Option func(*Client)
Option declares an option for the hcaptcha client. See `New` package-level function.
type Response ¶
type Response struct { ChallengeTS string `json:"challenge_ts"` Hostname string `json:"hostname"` ErrorCodes []string `json:"error-codes,omitempty"` Success bool `json:"success"` Credit bool `json:"credit,omitempty"` }
Response is the hcaptcha JSON response.
func Get ¶
Get returns the hcaptcha `Response` of the current request and reports whether was found or not.
func SiteVerify ¶
SiteVerify accepts an Iris Context and a secret key (https://dashboard.hcaptcha.com/settings). It returns the hcaptcha's `Response`. The `response.Success` reports whether the validation passed. Any errors are passed through the `response.ErrorCodes` field.