We have a RESTful implementation of our service at http://www.captcha4u.com/api.aspx
Your API key can be found on this page.
The API has 2 simple HTTP POST operations.
- upload_captcha
- get_result
- rate_result
upload_captcha
You must POST with "Content-Type: multipart/form-data".
There are 5 required parameters:
- method - upload_captcha
- api_key - string representing the API key
- file - transmit the CAPTCHA image
- expire - number of seconds after which CAPTCHA has expired (usually 60 or 300)
- rights - true or false
Possible results:
- FAILURE: access denied - get API key from website
- FAILURE: file_size=0
- SUCCESS: captcha_id=<string GUID>
get_result
You must POST.
There are 3 required parameters:
- method - get_result
- api_key - string representing the API key
- captcha_id - returned from upload_captcha
Possible results:
- FAILURE: access denied - get API key from website
- FAILURE: captcha_id not found
- FAILURE: expired
- WAIT: check back later
- SUCCESS: captcha_result=<textual representation of CAPTCHA>
rate_result
You must POST.
There are 3 required parameters:
- method - rate_result
- api_key - string representing the API key
- captcha_id - returned from upload_captcha
- success - 1 if captcha was correct, 0 if captcha was not correct
Possible results:
- FAILURE: access denied - get API key from website
- FAILURE: captcha_id not found
- SUCCESS: thanks