PerimeterX

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

Task Type

For the solution of PerimeterX, the task types we provide are as follows:

Task Type	Description	Price(USD)

Task Type	Description	Price(USD)
`PerimeterX`	`PerimeterX` Press&Hold Solution	$2.0/1k
PxInvisibleCaptcha	`PerimeterX` Invisible Cookie Solution	$0.5/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

Parameter Structure

Parameter	Type	Required	Description

Parameter	Type	Required	Description
clientKey	string	yes	Your client key
type	string	yes	`PerimeterX`
websiteKey	string	yes	website url, usually a fixed value.

Request Example

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

Content-Type: application/json

{
    "clientKey": "YourClientKey",
    "task": {
        "type": "PerimeterX",
        "websiteKey": "PXxxxxxxx",
    }
}

Reponse Example

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

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

Request Example

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

Content-Type: application/json
 
{
    "clientKey":"YOUR_API_KEY",
    "taskId": "TASKID OF CREATETASK" //ID created by createTask method
}

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 3 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.

Response Example

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "_px3":"xxx",
        "_pxvid": "xxx",
         "_pxde":"xxxx",
    },
    "status": "ready"
}

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 3 seconds.
An error occurred: when the errorId is greater than 0, please understand the error information according to the errorDescription All error descriptionsDemo