如何使用
你可以通过如下步骤,学会如何使用CapSolver的服务
第一步: 创建账号
当你准备好使用CapSolver 的服务之前,你需要到用户面板进行账号注册。你可以选择多种方式注册,如果你没有看到你想要的注册方式请联系我们。
第二步: 获取密钥
当你注册成功后,你可以在首页面板中获取得到请求API的令牌
第三步: 创建任务
当你准备好密钥后,你可以通过 createTask 我们的http接口进行任务的创建,下面将演示一个http请求的参数案例。
请求协议 headers
POST https://api.capsolver.com/createTask
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "https://www.google.com/recaptcha/api2/demo",
"websiteKey": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
//support cookies
"cookies": [
{
"name": "__Secure-3PSID",
"value": "AIKkIs3ch7YsxxxxYIzRqNZPGm60cdHozgwfUW1o8MF3kRcf8clJscTI6OtCqVpqNF8I88pLBJkUgQ"
},
{
"name": "__Secure-3PAPISID",
"value": "TKS1iVpGxYbxxxk0n2o/AytXQTb6RUALqxSEL"
}
]
}
}
当你的账户有充足的余额并参数无误的请求发送后,你将得到如下api接口结果响应
{
"errorId": 0,
"errorCode": "",
"errorDescription": "",
// 请记录此ID,后续查询任务结果会使用到
"taskId": "61138bb6-19fb-11ec-a9c8-0242ac110006"
}
我们目前支持的任务分多种类型,你可以使用 task > type
中的参数进行任务类型区分
- 图片识别/语音识别
- HCaptcha
- ReCaptchaV2
- AwsWAF
- Voice Recognition
- Captcha令牌
- HCaptcha
- GeeTest
- MtCaptcha
- ReCaptchaV2
- ReCaptchaV3
第四步: 获取任务执行结果
通常 识别任务 返回结果是直接通过 createTask 返回的,但 令牌任务 执行需要花费较多的时间,所以你需要单独通过 getTaskResult 获取任务结果。
请求协议 headers
POST https://api.capsolver.com/getTaskResult
Host: api.capsolver.com
Content-Type: application/json
{
"clientKey": "YOUR_API_KEY",
//第一步createTask返回的结果
"taskId": "37223a89-06ed-442c-a0b8-22067b79c5b4"
}
一般只需要等待 1-10s
你将可以通过 getTaskResult 获取到任务执行结果,下面是一个成功的响应
当你的账户有充足的余额并参数无误的请求发送后,你将得到如下api接口结果响应
{
"errorId": 0,
"solution": {
"userAgent": "xxx",
"gRecaptchaResponse": "03AGdBq25SxXT-pmSeBXjzScW-EiocHwwpwqtk1QXlJnGnUJCZrgjwLLdt7cb0..."
},
"status": "ready"
}