HCaptcha(Under maintenance, unavailable)

Create a task through the createTask method, and then get the result through the getTaskResult method

If you obtain an invalid token, please contact us. It will usually work normally after we optimize it.

Task Type

VIP7 Price

VIP7 Price

VIP7 Price

VIP7 Price

VIP7 Price

VIP7 Price

VIP7 Price

VIP7 Price

HcaptchaTaskProxyless

HCaptcha solution, using server built-in proxy

9 POINTS

$0.9/1k

Create Task

Create a task through the createTask method

Request host: https://api.ez-captcha.com

Request api: https://api.ez-captcha.com/createTask

Request format:POST application/json

Request Parameters

Parameters

Type

Required

Description

Parameters

Type

Required

Description

clientKey

string

yes

Account client key, which can be found in the personal center

type

string

yes

Task type: HcaptchaTaskProxyless

websiteURL

string

yes

Website url using HCaptcha, usually a fixed value

websiteKey

string

yes

HCaptcha site key, a fixed value。

enterprisePayload

object

no

Additional parameter that may be required by HCaptcha Enterprise, only support rqdata now (beta version):

"enterprisePayload": {"rqdata": "xxxxxxxxx"}

isInvisible

Bool

no

Set true if it's a invisible captcha

Request Example

POST https://api.ez-captcha.com/createTask Content-Type: application/json { "clientKey": "7e5ffc29e3354a19991002f2a19978bb696679", "task": { "websiteURL": "https://discord.com/register", "websiteKey": "4c672d35-0701-42b2-88c3-78380b0db560", "type": "HcaptchaTaskProxyless" } }

Response Example

{ "errorId": 0, "errorCode": "", "errorDescription": "", "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006" // Please record this ID }

Get Result

Use the getTaskResult method to get the recognition result

Request host: https://api.ez-captcha.com

Request api: https://api.ez-captcha.com/getTaskResult

Request format:POST application/json

Depending on system health, you will get results in 10s to 20s

Request Example

POST https://api.ez-captcha.com/getTaskResult Content-Type: application/json { "clientKey":"YOUR_API_KEY", "taskId": "TASKID OF CREATETASK" //Create by createTask api }

Response Data

Parameter

Type

Description

Parameter

Type

Description

errorId

Integer

Error message: 0 - no error, 1 - error

errorCode

string

Error code, click here to view all error list

errorDescription

string

Detailed error description

status

string

processing - task is in progress, please try again in 1 seconds

ready - task is complete, find the result in the solution parameter

solution

Object

The recognition result will be different for different types of captcha. For HCaptcha, the result is token in the object.

solution.token

string

Recognition result: token value, used for POST or simulate d submission to the target website.

It is recommended to use immediately

Response Example

Response Description

  • Successful recognition: when errorId is equal to 0 and status is equal to ready, the result is in the solution.

  • Identifying: When errorId is 0 and status is processing, please try again after 1 seconds.

  • An error occurred: when the errorId is greater than 0, please understand the error information according to the errorDescription All error descriptions