The following steps are invloved in our captcha service

1. User uploads the captcha using the function "UploadCaptchaAndGetText". this function will return the reference imageid for the uploaded image along with the captcha text. The returned imageid acts as a identifier for the uploaded image. Example of the result "1565895|HSDFG". We have another function called "UploadCaptchaAndGetText", this will return only the captcha text.

2. If you find the typed captcha text wrong, you can set the captcha as bad using the function "SetBadimage".

3. You can get the balance using the function "Request Balance" .

HTTP Request links:

File Upload And Get Text using CAPTCHA URL: www.UploadCaptcha.com/forms/FileUploadAndGetTextCaptchaURL.htm

File Upload And Get Text: http://UploadCaptcha.com/Forms/FileUploadAndGetTextNew.htm

Request Balance : http://UploadCaptcha.com/Forms/RequestBalance.htm

Set Bad Image : http://UploadCaptcha.com/Forms/SetBadImage.htm

Image Upload via file content posting: (Returns "ImageID|CaptchaText")

Request Parameters:

Action=upload

username= your username

password = your password

type = CS -- This is for CASE SENSITIVE (default -- Case Insensitive)

file=base64 encoded image file.

Response from server

ERROR: INVALID_REQUEST = It will be returned when the program tries to send the invalid request.

ERROR: INVALID_USERNAME = If the username is not provided, this will be returned.

ERROR: INVALID_PASSWORD = if the password is not provide, this will be returned.

ERROR: INVALID_IMAGE_FILE = No file uploaded or No image type file uploaded.

ERROR: AUTHENTICATION_FAILED = Provided username and password are invalid.

ERROR: INVALID_IMAGE_SIZE_30_KB = The uploading image file must be 30 KB.

ERROR: UNKNOWN = Unknown error happened, close the program and reopen.

ERROR: NOT_DECODED = The captcha is timedout

if success the captcha decoded text along with image id will be returned.

Example of output: "1245986|HGFJD"

Using the captcha id you can set the captcha as bad.

Example:

Image Upload via file content posting: (Returns "CaptchaText")

Request Parameters:

Action=upload

username= your username

password = your password

type = CS -- This is for CASE SENSITIVE (default -- Case Insensitive)

file=base64 encoded image file.

Response from server

ERROR: INVALID_REQUEST = It will be returned when the program tries to send the invalid request.

ERROR: INVALID_USERNAME = If the username is not provided, this will be returned.

ERROR: INVALID_PASSWORD = if the password is not provide, this will be returned.

ERROR: INVALID_IMAGE_FILE = No file uploaded or No image type file uploaded.

ERROR: AUTHENTICATION_FAILED = Provided username and password are invalid.

ERROR: INVALID_IMAGE_SIZE_30_KB = The uploading image file must be 30 KB.

ERROR: UNKNOWN = Unknown error happened, close the program and reopen.

ERROR: NOT_DECODED = The captcha is timedout

if success the captcha decoded text will be returned.

Example of output: "HGFJD"

Example:

Set Bad Image

Request Parameters:

Action=SetBadImage

username= your username

password = your password

imageid=Image id

Response from server

ERROR: INVALID_REQUEST = It will be returned when the program tries to send the invalid request.

ERROR: INVALID_USERNAME = If the username is not provided, this will be returned.

ERROR: INVALID_PASSWORD = if the password is not provide, this will be returned.

ERROR: AUTHENTICATION_FAILED = Provided username and password are invalid.

ERROR: UNKNOWN = Unknown error happened, close the program and reopen.

ERROR: INVALID_IMAGE_ID = Not provided image id or Provided invalid image id.

SUCCESS = If the image is set as bad.

Example:

Request Balance

Request Parameters:

Action=REQUESTBALANCE

username= your username

password = your password

Response from server

ERROR: INVALID_REQUEST = It will be returned when the program tries to send the invalid request.

ERROR: INVALID_USERNAME = If the username is not provided, this will be returned.

ERROR: INVALID_PASSWORD = if the password is not provide, this will be returned.

ERROR: AUTHENTICATION_FAILED = Provided username and password are invalid.

ERROR: UNKNOWN = Unknown error happened, close the program and reopen.

if success the amount will be returned.

Example:

Image Upload via CAPTCHA URL: (Returns "ImageID|CaptchaText")

Request Parameters:

Action=upload

username= your username

password = your password

type = CS -- This is for CASE SENSITIVE (default -- Case Insensitive)

file=ImageURL like http://www.site.com/test.jpg

Response from server

ERROR: INVALID_REQUEST = It will be returned when the program tries to send the invalid request.

ERROR: INVALID_USERNAME = If the username is not provided, this will be returned.

ERROR: INVALID_PASSWORD = if the password is not provide, this will be returned.

ERROR: INVALID_IMAGE_FILE = No file uploaded or No image type file uploaded.

ERROR: AUTHENTICATION_FAILED = Provided username and password are invalid.

ERROR: INVALID_IMAGE_SIZE_30_KB = The uploading image file must be 30 KB.

ERROR: UNKNOWN = Unknown error happened, close the program and reopen.

ERROR: NOT_DECODED = The captcha is timedout

if success the captcha decoded text along with image id will be returned.

Example of output: "1245986|HGFJD"

Using the captcha id you can set the captcha as bad.

Example: