The jDownloader/pyLoad API allows user to create a custom plugin for jDownloader, pyLoad or any other tools dealing with captcha recognition.
To submit a captcha or get the result provided on the Android device, the plugin must compute web accesses through the HTTP protocol to the jdCaptcha webserver at the address http://www.vincescodes.com/jdcaptcha/api.php. Both GET and POST are supported, POST is recommended.
For each access to the API, the server returns a JSON string containing the result of the action. It is recommended to check the status of the server response (it should be 200) before processing the JSON string. Also in case of errors on the server side, the result may not be a JSON string.
Mandatory parameters
For each access to the API a list of mandatory parameters must be provided, the following table provides the parameters and their description.
| Name | Description |
|---|---|
| username | The username used in the jdCaptcha website. |
| password | The API password available in the jdCaptcha website. |
| action | The requested action, see section below. |
| client | The plugin client ID, example pyload-python-linux. |
| version | The version of the API, use 6.0 at this time. |
Actions
The following table describes the action parameter.
If the server response contains host and port fields, it is mandatory to connect to the given host at the given port to continue (except the host and port, the API URL remains the same).
Reconnect to the server to get captcha solution should be proceed after the delay specified by the delay field.
| Value | Description | Extra parameters | Server Response |
|---|---|---|---|
| submit | Submit a captcha to the Android device. |
| {"status":"OK|FAIL","host":"www.vincescodes.com","port":80,"cid":1,"delay":120}If cid value is negative, it means that the captcha will not be sent to the device per user request. |
| status | Get the solution of the captcha submitted. |
| {"status":"OK|FAIL","result":"FAIL|captcha_solution","delay":40} |