Feedback Task

Report whether the generated token was accepted by the target site. This helps us improve solve quality and calculate accurate success rates.

POST/feedbackTask

Request Body

Parameter	Type	Required	Description
`clientKey`	string	Yes	Your API key
`taskId`	string	Yes	Task ID from createTask response
`result`	object	Yes	Feedback result object
`result.valid`	boolean	Yes	`true` if token was accepted, `false` if rejected

Example Request

Token was accepted

terminal

curl -X POST https://api.regotcha.com/feedbackTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "task_abc123xyz789",
    "result": {
      "valid": true
    }
  }'

Token was rejected

terminal

curl -X POST https://api.regotcha.com/feedbackTask \
  -H "Content-Type: application/json" \
  -d '{
    "clientKey": "YOUR_API_KEY",
    "taskId": "task_abc123xyz789",
    "result": {
      "valid": false
    }
  }'

Response

Success

success.json

{
  "errorId": 0,
  "message": "Feedback recorded: token valid"
}

Feedback Already Submitted

duplicate.json

{
  "errorId": 1,
  "errorCode": "ERROR_FEEDBACK_EXISTS",
  "errorDescription": "Feedback already submitted for this task"
}

Feedback Window Expired

expired.json

{
  "errorId": 1,
  "errorCode": "ERROR_FEEDBACK_EXPIRED",
  "errorDescription": "Feedback window expired (24h limit)"
}

Error Codes

Code	Description
`ERROR_KEY_DOES_NOT_EXIST`	Invalid API key
`ERROR_INVALID_TASK_DATA`	Missing or invalid result.valid field
`ERROR_NO_SUCH_CAPCHA_ID`	Task not found or not owned by this API key
`ERROR_FEEDBACK_EXISTS`	Feedback already submitted for this task
`ERROR_FEEDBACK_EXPIRED`	24-hour feedback window has expired

Best Practice: Submit feedback immediately after verifying the token with the target site. This helps us track real-world success rates and improve our solving algorithms.

Note: Feedback must be submitted within 24 hours of task completion. Each task can only receive one feedback submission.

Usage Example (Python)

example.py

import requests

def submit_feedback(api_key: str, task_id: str, token_worked: bool):
    """Submit feedback on whether the token was accepted."""
    response = requests.post(
        "https://api.regotcha.com/feedbackTask",
        json={
            "clientKey": api_key,
            "taskId": task_id,
            "result": {"valid": token_worked}
        }
    )
    return response.json()

# After using the token on your target site:
# - If the token was accepted, call: submit_feedback(api_key, task_id, True)
# - If the token was rejected, call: submit_feedback(api_key, task_id, False)