# GeeTest

Solve GeeTest v3 and v4 captcha challenges.

For GeeTest v3, the challenge value must be fresh for each task. Using an expired challenge will result in ERROR_TOKEN_EXPIRED and you will still be charged.

# GeeTest v3

# Basic usage

import { GeeTestTask } from "node-capmonster"

const client = new GeeTestTask("<api_key>")

const task = client.task({
    websiteURL: "https://example.com",
    gt: "022397c99c9f646f6477822485f30404",
    challenge: "<fresh_challenge_value>",
})

const taskId = await client.createWithTask(task)
const result = await client.joinTaskResult(taskId)

console.log(result.challenge)
console.log(result.validate)
console.log(result.seccode)

# V3 request parameters

Parameter	Type	Required	Description
`websiteURL`	string	Yes	Page URL (use actual Referer URL)
`gt`	string	Yes	GeeTest identifier key
`challenge`	string	Yes	Dynamic key — must be fresh
`geetestApiServerSubdomain`	string	No	API subdomain if not `api.geetest.com`
`geetestGetLib`	string	No	Captcha script path (JSON string)

# V3 response

Field	Type	Description
`challenge`	string	Challenge token
`validate`	string	Validate token
`seccode`	string	Seccode token

# GeeTest v4

# Basic usage

import { GeeTestV4Task } from "node-capmonster"

const client = new GeeTestV4Task("<api_key>")

const task = client.task({
    websiteURL: "https://example.com",
    gt: "54088bb07d2df3c46b79f80300b0abbe",
    initParameters: { riskType: "slide" },
})

const taskId = await client.createWithTask(task)
const result = await client.joinTaskResult(taskId)

console.log(result.captcha_id)
console.log(result.lot_number)
console.log(result.pass_token)
console.log(result.gen_time)
console.log(result.captcha_output)

# V4 request parameters

Parameter	Type	Required	Description
`websiteURL`	string	Yes	Page URL
`gt`	string	Yes	The `captcha_id` parameter
`initParameters`	object	Yes	Additional params with `riskType`

# V4 response

Field	Type	Description
`captcha_id`	string	Captcha ID
`lot_number`	string	Lot number
`pass_token`	string	Pass token
`gen_time`	string	Generation time
`captcha_output`	string	Captcha output