Hướng dẫn
Nhiệm vụ(Token)
reCAPTCHA v2

Giải quyết reCaptcha v2

TIP

Tạo nhiệm vụ bằng phương thức createTask và nhận kết quả bằng phương thức getTaskResult.

Các loại nhiệm vụ mà chúng tôi hỗ trợ:

  • ReCaptchaV2Task: Loại nhiệm vụ này yêu cầu bạn sử dụng proxy riêng của bạn.
  • ReCaptchaV2EnterpriseTask: Loại nhiệm vụ này yêu cầu bạn sử dụng proxy riêng của bạn.
  • ReCaptchaV2TaskProxyLess: Sử dụng proxy tích hợp sẵn trên máy chủ.
  • ReCaptchaV2EnterpriseTaskProxyLess: Sử dụng proxy tích hợp sẵn trên máy chủ.

Tạo Nhiệm Vụ

Tạo một nhiệm vụ nhận dạng bằng phương thức createTask.

Trước khi tạo một nhiệm vụ, bạn có thể tìm hiểu về các điều sau đây:

Nếu bạn nhận được phản hồi không hợp lệ, bạn có thể tìm hiểu về:

Cấu Trúc Đối Tượng Nhiệm Vụ

Thuộc TínhLoạiBắt BuộcMô Tả
TypeStringRequiredReCaptchaV2Task
ReCaptchaV2TaskProxyLess
websiteURLStringRequiredĐịa chỉ web của trang web sử dụng thường là giá trị cố định. (Ví dụ: https://google.com)
websiteKeyStringRequiredKhóa công khai của tên miền, hiếm khi được cập nhật. (Ví dụ: b989d9e8-0d14-41sda0-870f-97b5283ba67d)
proxyStringOptionalTìm hiểu thêm về Sử dụng proxy
pageActionStringOptionalMột số trang web trong điểm gốc có tham số “sa” (action), đó là giá trị hành động.
enterprisePayloadObjectOptionalThông tin Enterprise Payload
isInvisibleBoolOptionalNếu reCaptcha không có pageAction, cờ “fi” trong nội dung yêu cầu gửi lại có giá trị “fi”.
apiDomainStringOptionalĐịa chỉ miền từ đó tải reCAPTCHA Enterprise.
Ví dụ:
• http://www.google.com/
• http://www.recaptcha.net/
Không sử dụng tham số này nếu bạn không biết tại sao cần nó.
userAgentStringOptionalUser-Agent của trình duyệt được sử dụng trong mô phỏng. Yêu cầu sử dụng User-Agent của trình duyệt hiện đại, nếu không, Google sẽ yêu cầu bạn “cập nhật trình duyệt”.
cookiesArrayOptionalTìm hiểu thêm về Sử dụng Cookies
anchorStringOptionalCách solve tất cả các phiên bản của reCAPTCHA Enterprise v2, v2 ẩn danh, v3, v3 enterprise với điểm số 0.9
reloadStringOptionalCách solve tất cả các phiên bản của reCAPTCHA Enterprise v2, v2 ẩn danh, v3, v3 enterprise với điểm số 0.9

Ví dụ Yêu Cầu

POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
  "clientKey": "YOUR_API_KEY",
  "task": {
    //Bắt Buộc
    "type": "ReCaptchaV2Task",
    //Bắt Buộc
    "websiteURL": "https://www.google.com/recaptcha/api2/demo",
    //Bắt Buộc
    "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
    "enterprisePayload": {
      //Tùy Chọn, bắt buộc nếu trang web sử dụng reCaptcha Enterprise
      "s": "SOME_ADDITIONAL_TOKEN"
    },
    "isInvisible": false,
    // Tùy Chọn
    "pageAction": "submit",
    //Tùy Chọn
    "apiDomain": "",
    //Tùy Chọn
    "userAgent": "",
    //Tùy Chọn
    "cookies": [
      {
        "name": "__Secure-3PSID",
        "value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozg
 
wfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
      },
      {
        "name": "__Secure-3PAPISID",
        "value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
      }
    ],
    //Tùy Chọn                
    "proxy": "http:ip:port:user:pass",
    // socks5:ip:port:user:pass
    //Tùy Chọn, Sau khi bạn chỉ cần gửi một lần và nhận kết quả thành công, bạn có thể loại bỏ tham số này
    "anchor": "base64 content",
    "reload": "base64 content"
  }
}

Sau khi bạn gửi nhiệm vụ cho chúng tôi, bạn nên nhận được một ‘Task id’ trong phản hồi nếu thành công. Vui lòng đọc errorCode: full list of errors nếu bạn không nhận được Task id.

Ví dụ Phản hồi

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

Nhận Kết Quả

Sau khi bạn có taskId, bạn cần gửi taskId đó để nhận giải pháp. Cấu trúc phản hồi được giải thích trong getTaskResult.

Tùy thuộc vào tải hệ thống, bạn sẽ nhận được kết quả trong khoảng từ 1 giây đến 10 giây.

Ví dụ Yêu Cầu

POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
 
{
    "clientKey": "YOUR_API_KEY",
    "taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}

Ví dụ Phản hồi

{
    "errorId": 0,
    "errorCode": null,
    "errorDescription": null,
    "solution": {
        "userAgent": "xxx", // User-Agent
        "expireTime": 1671615324290, // Thời gian hết hạn của mã token
        "gRecaptchaResponse": "3AHJ....." // Mã token giải quyết
    },
    "status": "ready"
}

Sử Dụng Yêu Cầu SDK

Ví dụ Python:

#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'
 
import capsolver
# capsolver.api_key = "..."
solution = capsolver.solve({
            "type": "ReCaptchaV2TaskProxyLess",
            "websiteURL": "https://www.google.com/recaptcha/api2/demo",
            "websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
          })

Ví dụ Go (Golang):

package main
 
import (
	"fmt"
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)
 
func main() {
	// Trước tiên, bạn cần cài đặt SDK
	// go get github.com/capsolver/capsolver-go
	// export CAPSOLVER_API_KEY='...' hoặc
	// capSolver := CapSolver{ApiKey:"..."}
 
	capSolver := capsolver_go.CapSolver{}
	solution, err := capSolver.Solve(map[string]any{
		"type": "ReCaptchaV2TaskProxyLess",
		"websiteURL": "https://www.google.com/recaptcha/api2/demo",
		"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
	})
	if err != nil {
		log.Fatal(err)
		return
	}
	fmt.Println(solution)
}
GeetestreCAPTCHA v3