Subversion Repositories SmartDukaan

package com.smartdukaan.cron.scheduled;

/**

 * Supplies a g-recaptcha-response token for the Motorola warranty page.

 *

 * The page is Oracle Service Cloud (RightNow). Its lookup endpoint answers

 * "==CHALLENGE REQUIRED==" and hands back a Google reCAPTCHA v2 config

 * (sitekey 6LcHf0wUAAAAAFxRHKequHkHUGyUWA5dy24ZaB5s) instead of the warranty

 * payload, on the FIRST lookup of a clean session -- it is not rate-triggered.

 *

 * This is deliberately an unimplemented seam. reCAPTCHA v2 is not a puzzle with

 * a computable answer the way vivo's 4-char image or the oppo/realme DingXiang

 * slider are, so there is no solver to write here in the way CaptchaService

 * solves vivo. Point this at whatever token source is actually sanctioned --

 * the Lenovo partner warranty API (supportapi.lenovo.com, ClientID-based) is

 * the route that removes the need for a browser at all.

 *

 * Until a bean implementing this exists, CheckMotorolaWarrantyTask detects the

 * challenge, logs it once, and abandons the batch rather than hammering the

 * endpoint with lookups that cannot succeed.

 */

public interface MotorolaChallengeSolver {

    /**

     * @param siteKey reCAPTCHA sitekey scraped from the challenge payload

     * @param pageUrl the warranty page the challenge was raised on

     * @return a token to post back as g-recaptcha-response, or null if none

     *         can be supplied (the caller then skips the batch)

     */

    String solve(String siteKey, String pageUrl);

}