DBC: Image
Description
Use the step to retrieve the text from a word CAPTCHA image. It uses Death By Captcha (DBC) REST APIs to resolve CAPTCHA text.
Prerequisite
User must have DBC: Image account in order to use the services. The DBC REST API base URL is, Captcha.
Configurations
| Field name | Description |
|---|---|
| Step name | Specify a unique name for the step. |
| DBC ACCOUNT DETAILS | |
| Use HTTPS | Select the checkbox if you want to switch the communication protocol between standard HTTP and secure HTTPS. When you select the Use HTTPS checkbox, the application sends the CAPTCHA request to the API endpoint using the https:// protocol. This initiates a secure connection, where all data exchanged between your system and the API server is encrypted. This encryption prevents anyone from intercepting and reading the API request, which might include your username, password, or the CAPTCHA data itself. If the box is unchecked, it falls back to the standard, unencrypted http:// protocol. For any real-world use, keeping this box checked is highly recommended. For example, https://api.dbcapi.me/api/captcha |
| URL | Displays the URL of the REST API of your DBC account. |
| Username | Specify the username of your DBC account. |
| Password | |
| Accept value as variable/static | Specify or select the password, as required. If the Accept Value as variable/static checkbox is selected, then the password field appears as a text box and accepts static or variable values. OR If the Accept Value as variable/static checkbox is clear, then the password field appears as a dropdown in which you can select a field from the previous steps. |
| INPUT tab: | Input Fields |
| CAPTCHA Image File Path | Specify the CAPTCHA image file path. The field is mandatory. Notes: * The supported image file formats are: JPG, PNG, GIF, and BMP. * The file size should be less than 180 KB. |
| Browse | Click to select the CAPTCHA file. |
| Retry If DBC Service Is Temporarily Unavailable | |
| Max Retry Count | Specify the number of times the server is expected to retry if the DBC service is temporarily unavailable. The data type is integer. The default value of Retry Count is 5. Notes: * When the DBC service is temporarily unavailable, the value in the field specifies the number of times the server should retry uploading the image and calling the API after every specified interval in seconds. * Execution should fail if CAPTCHA is not yet resolved after polling 10 times with specified interval in seconds. |
| Retry Interval (Seconds) | Specify the retry time interval in seconds between every retry attempt (Polling repeat interval) in case DBC server is temporarily unavailable or CAPTCHA is not resolved. The data type is integer. The default value is 2. Notes: * If in the first attempt, the API fails to retrieve the CAPTCHA text, that is, the result returned by the API is blank, then it will internally retry polling for maximum of 10 times after every specified interval in seconds until it gets the CAPTCHA text. * The minimum retry interval must not be less than 2 seconds. |
| Timeout (Seconds) | This field is a numeric input that lets you define how long your application will wait for the CAPTCHA API server to respond before giving up. The single value you enter in the "Timeout (Seconds)" field controls three distinct internal timeout settings, making the configuration simple yet powerful: - connectTimeout: This is the maximum time to wait to establish a connection with the server. If the server is offline or unreachable, your application will stop trying to connect after this period. - connectRequestTimeout: This is the time spent waiting for a connection from the internal connection pool. This is relevant in high-load scenarios and prevents your application from getting stuck if all connections are temporarily busy. - socketTimeout: Also known as the read timeout, this is the most common one. Once a connection is successfully established, this is the maximum time your application will wait for data to be received from the server. |
| OUTPUT tab: | CAPTCHA Text: |
| CAPTCHA Text | Output field to hold the resolved CAPTCHA text. Default Value: CAPTCHA Text |
List of Validations:
| Sr. No. | Validation |
|---|---|
| 1 | CAPTCHA image file should be of one of the supported formats i.e. JPG, PNG, GIF and BMP |
| 2 | CAPTCHA image file size is limited to less than 180 KB |
| 4 | Minimum Retry Interval should not be less than 2 seconds. |
| 5 | Execution should fail if CAPTCHA is not yet resolved after polling 10 times with specified Interval in Seconds |