Authorize

Authorizes a CAPTCHA token.

Following CAPTCHA verification on the client side, you must authorize the generated CAPTCHA token in the backend.

Authorize checks if the token is valid, making sure it was not tampered with or timed out.

If you're developing a Wix site or Blocks app, call this method when working with the Wix reCAPTCHA element.

If CAPTCHA token authorization fails, the method returns an error message containing a status code. The following table lists the possible HTTP error status codes, based on RFC 2616:

Status Code	Name	Description
400	Bad Request	The request could not be understood by the server. This could occur for a number of reasons, such as: The request was sent without a token. The token is invalid. The token has timed out.
401	Unauthenticated	No user identity found in passed request.
500	Internal Server Error	The server encountered an unexpected condition, such as a missing or invalid private CAPTCHA key.
503	Unavailable	The service is unavailable due to one of the following: Throttled error: Server overload due to more than the allowed requests in a given time frame. Request failed: No response following 10 retries with a 1-second interval.