页面比较

...

说明
此接口开发难度较高，建议想节省时间的可以直接安装浏览器插件，自动点击通过点此查看

创建任务

通过 createTask方法创建识别任务

请求节点：
状态
colour Green
title 国际节点
https://api.yescaptcha.com
状态
colour Green
title 国内节点
https://cn.yescaptcha.com
请求地址： https://api.yescaptcha.com/createTask
请求格式：POST application/json

对象结构

属性

类型

必须

说明

type

string

是

ReCaptchaV2Classification 300x300 450x450

状态

colour	Green
title	10 点数

100x100

状态

colour	Green
title	2 点数

image

string

是

Base64 编码的图片，不要包含 "data:image/***;base64,"

说明
必须将图片缩放至标准大小 (100x100, 300x300, 450x450), 这样服务才能判断图片类型

question

String

是

问题 ID, 请查表, 以 /m/ 开头

confidence

int

否

结果置信度分值，非必填，0.0 不匹配 ~1.0 完全匹配（分值越大匹配度越高），默认值为空

对于3x3 类型的图片，当指定一个分值时（建议0.5），会返回所有大于该分值的结果，不指定时会返回排名前三的结果。

对于4x4和1x1的图片指定此值无意义

具体使用场景见下方说明。

请求示例

代码块

language	json

{
    "clientKey": "cc9c18d3e263515c2c072b36a7125eecc078618f",
    "task": {
        "type": "ReCaptchaV2Classification",
        "image": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDc....",
        "question": "/m/0k4j"
    }
}

响应示例

代码块

{
    "errorId": 0,
    "errorCode": "",
    "errorDescription": "null",
    "status": "ready",
    "taskId": "3a9e8cb8-3871-11ec-9794-94e6f7355a0b",
    "solution": {
        "objects": [1,5,8], // 图像需要点击的位置
        "type": "multi"
    }
}

图片格式

标准大小 3x3: (300x300)

状态

colour	Green
title	10 POINTS

可以是截图：按照返回结果点击对应位置

...

代码块
"solution": { "hasObject": true / false, // 判断是否为目标物体 "type": "single" }

...

问题 ID的查找方式

...

ID 对照表：中文并非 ReCaptcha 官方翻译, 仅供参考

...

代码块

{
  "/m/0pg52": "taxis",
  "/m/01bjv": "bus",
  "/m/02yvhj": "school bus",
  "/m/04_sv": "motorcycles",
  "/m/013xlm": "tractors",
  "/m/01jk_4": "chimneys",
  "/m/014xcs": "crosswalks",
  "/m/015qff": "traffic lights",
  "/m/0199g": "bicycles",
  "/m/015qbp": "parking meters",
  "/m/0k4j": "cars",
  "/m/015kr": "bridges",
  "/m/019jd": "boats",
  "/m/0cdl1": "palm trees",
  "/m/09d_r": "mountains or hills",
  "/m/01pns0": "fire hydrant",
  "/m/01lynh": "stairs"
}

错误信息

errorCode	errorDescription	说明
ERROR_INTERNAL_SERVER_ERROR	服务器内部错误	请确保各项参数正确
ERROR_UNKNOWN_QUESTION	错误的问题ID	请检查问题ID是否正确
ERROR_ILLEGAL_IMAGE	图片大小不符合要求	请缩放至指定大小450x450/300x300/100x100
ERROR_UNKNOW_450x450_QUESTION	这个尺寸暂时不支持这个问题	暂时不能很好的识别这个问题相关的图片，请重试其他类型的图片
ERROR_PARSE_IMAGE_FAIL	解析图片失败	请确认图片BASE64编码是否正确

字段confidence使用说明

reCaptcha有三种类型的需要识别，1种是3x3的九宫格，1种是4x4的十六宫格，当3x3的图片点击之后会继续刷新小图，这种就是1x1的小图。

...

如果没有符合条件的，会返回空数组。

此时根据结果再次点击即可

截图如何判断是3x3还是4x4

如果是网页处理，直接获取图片传到接口，服务器会根据图片尺寸自动判断类型（根据图片大小）

...

版本比较

旧版本 1

新版本 2

密钥