NetEase Yidun captcha

NetEase Yidun captcha: parameters, request, response and the 2Captcha method of YidunTaskProxyless and YidunTask.

On this page

Rules
Parameters
Request
Response
2Captcha in.php

NetEase Yidun (NECaptcha): the widget with a captcha id, including its Enterprise mode with a challenge.

Status	coming soon
Type codes	`YidunTaskProxyless` — without a proxy; `YidunTask` — with your proxy
Proxy	optional: the second code takes your proxy
Also accepted as	`YidunTaskProxyLess`
Price	set when the type is switched on — see pricing

Rules#

The proxy code solves through your proxy, so the answer is issued for your IP address. See Proxies.

Parameters#

Fields of the task object in createTask:

ParameterDescription

type stringrequired: Task type: YidunTaskProxyless, YidunTask.
websiteURL stringrequired: Full address of the page with the captcha: http(s), up to 2048 characters, a public site.
websiteKey stringrequired: Site key of the widget on the page. Letters, digits and _ - . :, up to 128 characters.
yidunGetLib string: URL of the loader script (recommended for Enterprise). Absolute http(s) URL of a public site, up to 2048 characters.
yidunApiServerSubdomain string: Custom API host, for example c.dun.163.com. A host name such as api.example.com; a leading https:// is dropped.
challenge string: The Enterprise challenge. Letters, digits and _ - . :, up to 256 characters.
hcg string: The captcha hash (Enterprise). Letters, digits and _ - . :, up to 256 characters.
hct integer: The Enterprise timestamp id. Integer.
userAgent string: User-Agent of the browser that will use the answer, up to 512 characters.
proxyType string: http (default), https, socks4 or socks5.
proxyAddress stringfor proxy types: IP address or host name of the proxy. Private and local addresses are rejected.
proxyPort integerfor proxy types: Proxy port, 1–65535.
proxyLogin string: Proxy login, up to 256 characters. Stored encrypted.
proxyPassword string: Proxy password, up to 256 characters. Stored encrypted.

Request#

A YidunTaskProxyless task:

POST /createTask

{
  "clientKey": "YOUR_API_KEY",
  "task": {
    "type": "YidunTaskProxyless",
    "websiteURL": "https://example.com/login",
    "websiteKey": "SITE-KEY-1234"
  }
}

Response#

getTaskResult once the task is solved:

getTaskResult

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "token": "TOKEN_eyJhbGciOiJIUzI1NiJ9…",
    "userAgent": ""
  },
  "cost": "0.001500",
  "ip": "198.51.100.7",
  "createTime": 1793370000,
  "endTime": 1793370012,
  "solveCount": 1
}

2Captcha in.php#

The same task through the 2Captcha API: method=yidun, parameters → task fields:

in.php	task
`pageurl`	`websiteURL`
`sitekey`	`websiteKey`
`yidun_get_lib`	`yidunGetLib`
`yidun_api_server_subdomain`	`yidunApiServerSubdomain`
`challenge`	`challenge`
`hcg`	`hcg`
`hct`	`hct`
`useragent`	`userAgent`

res.php returns token of the solution as text (OK|…), or in request with json=1.