9.6. mollom.checkCaptcha
mollom.checkCaptcha |
|||
| Required | Name | Type | Description |
| required | public_key |
string | Site public key |
| required | time |
string | Site server time in this format: yyyy-MM-dd'T'HH:mm:ss-.SSSZ |
| required | hash |
string | HMAC-SHA1 digest |
| required | nonce |
string | One time nonce |
| required | session_id |
string | Session ID associated with the CAPTCHA |
| required | solution |
string | Submitted CAPTCHA solution |
| optional | author_ip |
string | Submitting user's current IP |
| optional | author_id |
string | Submitting user's unique ID (on the site) |
| returns | boolean | True if correct, false if incorrect | |
To validate a visitor's CAPTCHA answer, it has to be sent with the appropriate session ID to Mollom to be checked. Mollom will return a Boolean where true means that the CAPTCHA was filled out correctly, and false means that the answer was incorrect.
When the result is incorrect, a new CAPTCHA can be requested from Mollom by calling mollom.getImageCaptcha or mollom.getAudioCaptcha again. When making a request following a failed response, the active session_id must be specified in the call. This enables Mollom to do proper accounting and identify spambots trying to solve CAPTCHAs by brute force.