
Lucas Mitchell
Automation Engineer
已发表 Nov 17, 2026
已更新 Nov 17, 2026 · 最小阅读量

Postman 是一个用于构建请求、检查响应并组织可复用集合的 API 客户端。当开发者想要把“请求格式问题”与 SDK 或应用程序自身的 Bug 区分开时,它非常有用。你无需同时调试浏览器、应用和求解客户端,而是可以先单独检查 API 请求与响应。
本教程使用 CapSolver 作为有文档的 API 示例。工作流程涵盖账户认证、任务提交和结果检查。它并不声称 Postman 能操作浏览器或自动完成受保护表单。请在从 API 结果进入应用测试时,使用你自己的测试页面或其他明确授权的流程。
你需要一个 Postman 客户端,一个 CapSolver API key,以及你计划测试的特定 CAPTCHA 任务的有效输入。
对 token 类任务,通常需要页面 URL 和公共 site key,加上该任务当前文档要求的任何额外字段。请从你实际使用的受支持任务类型开始。不要从其他 CAPTCHA 服务中找一个类似的名字代替,也不要假设 reCAPTCHA 示例可以适用于所有提供商。
请区分三类凭证。你的 CapSolver 账号密钥用于认证求解 API 请求。网站的 site key 用于标识其 CAPTCHA 配置。网站所有者用于验证的 secret 属于网站后端,它不是求解服务的账户密钥。这一差别可以避免在发出第一条请求前常见的配置错误。
为这次测试使用单独的环境。Postman 支持请求中的变量,可避免在多个地方重复编辑同一个值。请使用团队认可的本地或密钥库机制存储真实机密。切勿发布包含账户密钥的已导出集合。也要检查继承的鉴权设置:不相关的 collection 级 Bearer Token 不能代替文档中要求的 clientKey 字段。
**验证边界:**下面的请求格式来自当前官方 API 文档。占位符需要由你自己的凭证和已授权页面输入替换。使用 Postman Newman 携带刻意无效的占位符密钥发起的 getBalance 请求,成功到达官方端点并返回了 JSON API 错误。这只验证了“认证失败路径”;成功认证、任务创建和 CAPTCHA 求解需要你自己的账户,并未在该检查中被实际执行。
getBalance 请求是验证账户认证而不创建付费求解任务的最简单方式。
创建一个指向 https://api.capsolver.com/getBalance 的 POST 请求。选择 raw JSON 请求体,并确认请求使用 Content-Type: application/json。使用官方的getBalance 请求结构,在本地替换占位符:
{
"clientKey": "YOUR_API_KEY"
}
发送请求并检查响应体。仅有 HTTP 响应还不够:要检查 API 的错误字段。认证成功的响应会包含文档中记录的账户信息。认证错误则说明你需要在测试 CAPTCHA 任务之前先修正密钥或账户访问问题。
如果 Postman 收到的是 HTML、代理错误或意外重定向,请先检查 URL 和返回该响应的组件。不要试图通过求解 CAPTCHA 来诊断一个错误的 API 端点。保持 TLS 验证开启;证书错误应当被排查,而不是在客户端设置中被隐藏。
Postman 也可以导入 cURL 请求。其导入文档解释了这一流程。如果你导入了一个官方示例,随后要检查其方法、URL、头和请求体。导入请求并不能证明其中的凭证或任务输入是有效的。
createTask 用于提交一个 CAPTCHA 求解任务;任务类型决定请求体中应包含哪些字段。
对标准的、免代理 reCAPTCHA v2 任务,官方的 reCAPTCHA v2 参考 定义了如下结构。这是一个示例请求模板:在发送到 https://api.capsolver.com/createTask 之前,请将所有占位符替换为你已授权测试页面的真实值。
{
"clientKey": "YOUR_API_KEY",
"task": {
"type": "ReCaptchaV2TaskProxyLess",
"websiteURL": "YOUR_AUTHORIZED_PAGE_URL",
"websiteKey": "YOUR_WEBSITE_SITE_KEY"
}
}
任务类型的大小写很重要。请从官方参考中复制字段名称,而不是从产品名中猜测。不要为了弥补一个尚未找到原因的错误而擅自添加不受支持的参数。
将这个请求与余额请求分开保存。给它一个有描述性的集合名称,例如任务类型加测试环境,以免在检查开发环境页面时误跑了生产任务。对于手动测试,点击一次 Send 并先检查结果,再进行其他操作。
如果响应报告错误,请先修正该错误再继续。如果创建了异步任务,请保存其返回的 taskId。后续请求必须使用这个精确的标识符。反复点击 createTask 的 Send 会不断创建新任务;那不是询问现有任务状态的方式。
兑换 CapSolver 奖励码
立即提升你的自动化预算!
在为 CapSolver 账户充值时使用奖励码 CAP26,每次充值可额外获得 5% 奖励——没有上限。
现在就到你的 CapSolver 控制台 中兑换。
对异步任务,getTaskResult 用于检查你已经提交的任务。
为 https://api.capsolver.com/getTaskResult 创建单独的 POST 请求。官方的任务结果请求 使用相同的账户密钥和返回的任务标识:
{
"clientKey": "YOUR_API_KEY",
"taskId": "TASK_ID_RETURNED_BY_CREATE_TASK"
}
在解读状态前先检查 errorId。processing 状态表示尚无可用的 solution。ready 状态表示你可以检查文档中描述的 solution 对象。对于上述 reCAPTCHA v2 任务,token 会在 solution.gRecaptchaResponse 字段中返回。其他任务类型返回的字段可能不同,因此要根据任务契约选择相应的解析方式。
在学习整个交互过程时,请先从手动请求开始。根据当前文档的轮询建议等待一定时间再检查,并在预设的任务截止时间后停止。不要把 createTask 放在重复运行的集合中仅仅为了模仿轮询。如果你的应用之后自动化轮询,请在这次尝试中始终使用同一个 taskId,并明确处理终止性错误。
任务结果属于敏感的运行数据。与同事分享截图时要对 token 做脱敏。任务标识和错误码通常已经足以解释请求问题;完整响应数据往往并非必要。
ImageToTextTask 会在 createTask 的响应中直接返回识别文本,而无需 getTaskResult。
在测试文字 CAPTCHA 图片时,请使用官方的 ImageToTextTask 参考。其 body 字段包含图片的 Base64 数据。请将该图片与报告 PDF、发票文档或全页浏览器截图区分开来:该端点仅用于文档中描述的图片识别任务,而非任意文档提取。
先检查响应中是否存在 API 错误,然后在调用成功时读取 solution.text。以字符串形式保存该结果。将识别出的值(如 0072)转换为数字会在应用有机会验证答案之前改变其内容。
这种直接响应的行为也是“用一个通用集合循环作为起点”并不好的原因。请为你所需的任务单独构建一个小请求组,并遵守该组的实际返回契约。已有的图像转文字 API 指南更详细地解释了输入与输出边界。
当你区分 HTTP 交互、API 结果和网站结果后,排障会更高效。
在 HTTP 层,检查实际目标地址、响应类型以及客户端是否收到了响应。在 API 层,检查 errorId 和文档中的错误码。在网站层,检查应用是否接受了正确关联且仍在有效期内的 solution。官方错误码列表是了解 API 错误含义的权威来源。
如果 balance 请求失败,此时无需优先修改任务参数。如果余额认证成功但 createTask 失败,请检查所选任务类型及其必填字段。如果任务状态为 ready 但应用拒绝了结果,重复发送同一 Postman 请求可能只会创建额外任务。此时应检查页面上下文和网站的验证路径。
不要把成功收到 token 的响应描述为端到端浏览器测试。Postman 并未自动将 token 提交给你的应用、保持浏览器状态、提交表单或验证业务结果。对于你自己的 reCAPTCHA 集成,Google 的服务端验证文档解释了网站自身应承担的职责。
一个有用的集合应保留请求结构和预期的响应检查,同时在共享产物中剔除凭证。
请分别保存余额查询、任务创建和任务结果的不同请求。说明哪些值由用户提供,哪些来自之前的响应。在导出集合前清除示例 token 和账户密钥。不要假设界面中被掩码的字段在导出文件中也是安全的,请实际检查导出的 JSON。
Postman 的集合运行器可以帮助你重复执行受控的请求序列。请保持范围明确:请求格式检查、认证检查和付费求解是不同的测试。对最后一种测试,请使用一小部分获批的测试预算,并配合已知任务输入和清晰的终止条件。
在增加应用复杂度之前,先用 Postman 将 API 交互变得可见。一旦请求字段和结果处理逻辑正确无误,再把同一套经过文档验证的契约迁移到你的应用中,并验证其真实结果。CapSolver 提供受支持的求解步骤;你的工作流则仍需对如何正确使用该结果负责。
问:Postman 能自己解决 CAPTCHA 吗?
Postman 只负责发送 API 请求。CAPTCHA 求解服务负责执行受支持的求解任务,而你的应用负责处理返回的结果。
问:CapSolver 的 API key 应该放在哪里?
放在文档 JSON 请求体中的 clientKey 字段里。请对真实值保密,并不要把它与网站的公共 site key 混为一谈。
问:每个任务都需要 getTaskResult 吗?
不需要。异步任务使用任务结果端点,而 ImageToTextTask 会直接返回识别结果。请遵循你所选任务类型的当前文档说明。
问:为什么我已经收到了 token,但网站仍然失败?
网站有其独立的接受步骤。一个当前有效且正确关联的 token 必须在合适的应用流程中被使用;在 Postman 中收到它并不会自动完成该流程。
问:等待结果时应该反复运行 createTask 吗?
不应该。请使用 getTaskResult 携带已有异步任务的 taskId 进行查询。反复创建任务不是轮询,只会制造不必要的工作量和费用。

Lucas Mitchell
Automation Engineer
Helping browser automation recover and continue.
关于作者