III.2.e. Captcha

Contents

• Captcha fields
• Get captcha quota
• Get Node captcha challenge
• Get Codecha challenge

Captcha fields

Google reCAPTCHA

See: Developer's Guide for more details.

Google reCAPTCHA v1

• recaptcha_challenge_field The challenge.
• recaptcha_response_field User response.

Node captcha

• nodeCaptchaChallenge The challenge.
• nodeCaptchaResponse User response.

Codecha

• codecha_challenge_field The challenge.
• codecha_response_field User response.

Requests

Get captcha quota

/api/captchaQuota.json?boardName=<boardName>

Returns captcha quota (number of posts a user may submit without solving a captcha) for the current user.

Example:

/api/captchaQuota.json?boardName=b

{
    quota: 2
}

On any error, an error object is returned.

Example:

{
    "title": "Error",
    "errorMessage": "Error",
    "errorDescription": "Invalid board"
}

Get Node captcha challenge

/api/nodeCaptchaImage.json

Returns an object containing challenge and challenge file name. Files are located at ./public/node-captcha.

Example:

/api/nodeCaptchaImage.json

{
    "challenge": "550e8400-e29b-41d4-a716-446655440000",
    "fileName": "1458478662244.png"
}

On any error returns an error object.

Get Codecha challenge

/api/codechaChallenge.json

Returns the challenge string.

Example:

/api/codechaChallenge.json

4fe088447eea40b4a5a6d9af98a4d657

On any error, returns an error object.