- to get started
- Cloud content
- Cloud Data
- User Subscription
- User Session
- User Profile
- Email services
challenge_new generates CAPTCHA-like challenges. It returns an associative array composed of two elements:
token is a single-use token ID which is required to check the challenge value. This token is
alivefor one hour. After this delay, a new challenge must be generated.
- img is a string which contains a base64-encoded picture.
See below an example of return data:
Checking a challenge value may done either with the generic API challenge_check as used in the test bed below, or in the context of some specific API such as subscribe or password_reset which require a challenge value and a token ID as parameters.
http method: POST
call cost: 1 point
See the pricing section for more details.
|parameter||values / comments|
|key||E.g. "c54e7837e0cd0ced286cb5995327d1ab54e35987179b2". It is an application key generated by AuverCloud Studio.|
|height||Picture height (in pixels). The value must be between 5 and 200. The picture width is always 6 times the picture height.|
|method||The challenge method to choose in the two following values:
|color||Text color: Either the keyword "random" or an hexadecimal 6-digits color e.g. "00aa00".|
See also the Common errors section.
See the API challenge_check to check the value that you can infer from the picture below.