9.6. mollom.checkCaptcha

Note

The Mollom XML-RPC API interface has been deprecated, and is included here for archival purposes.

To develop clients and services that connect to Mollom, use the Mollom REST API.

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.