import { RequestOptionsFactory } from '@wix/sdk-types';
/**
 * 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](https://dev.wix.com/docs/velo/api-reference/$w/captcha/introduction) 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](https://datatracker.ietf.org/doc/html/rfc2616#section-10):
 *
 *
 * | 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: <ul> <li>The request was sent without a token.</li> <li>The token is invalid.</li> <li>The token has timed out.</li> </ul> |
 * | 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: <ul> <li>Throttled error: Server overload due to more than the allowed requests in a given time frame.</li> <li>Request failed: No response following 10 retries with a 1-second interval.</li> </ul> |
 */
export declare function authorize(payload: object): RequestOptionsFactory<any>;