Pular para o conteúdo principal
Está tendo problemas para obter o token?
Entre em contato com o suporte

TenDI - Captcha da Tencent

Mais informações sobre o tema em nosso blog
Atenção!

Essa tarefa será realizada usando nossos servidores proxy.

Parâmetros da solicitação

type<string>required

CustomTask


class<string>required

TenDI


websiteURL<string>required

O endereço da página principal onde o captcha é resolvido.


websiteKey<string>required

captchaAppId. Por exemplo, "websiteKey": "189123456" é um parâmetro único para seu site. Você pode obtê-lo de uma página HTML com captcha ou a partir do tráfego (veja a descrição abaixo).


metadata.captchaUrl<string>optional

Link para o script do captcha. Normalmente termina com TCaptcha.js ou TCaptcha-global.js. Pode ser encontrado na lista de requisições (veja o exemplo abaixo).


userAgent<string>optional

O User-Agent do navegador. Passe apenas o UA real de um sistema operacional Windows. Atualmente, a versão é: userAgentPlaceholder


proxyType<string>optional

http - proxy regular http/https;
https - use essa opção apenas se "http" não funcionar (necessário para alguns proxies personalizados);
socks4 - proxy socks4;
socks5 - proxy socks5.


proxyAddress<string>optional

Endereço IP do proxy IPv4/IPv6. Não permitido:

  • uso de nomes de host;
  • uso de proxies transparentes (onde é possível ver o IP do cliente);
  • uso de proxies em máquinas locais.


proxyPort<integer>optional

Porta do proxy.


proxyLogin<string>optional

Login do servidor proxy.


proxyPassword<string>optional

Senha do servidor proxy.

Como obter websiteKey (captchaAppId)

Ative as Ferramentas de Desenvolvedor, vá para a aba Network, ative o captcha e veja as solicitações. Algumas delas conterão o valor do parâmetro que você precisa. Nesse caso, websiteKey=aid

Como obter captchaUrl

Abra Ferramentas de Desenvolvedor, vá para a aba Network, ative o captcha e examine as requisições de rede. Entre elas aparecerá TCaptcha.js ou TCaptcha-global.js, no qual você pode encontrar um link semelhante a este:

Método de criação da tarefa

POST
https://api.capmonster.cloud/createTask

Solicitação

{
"clientKey": "API_KEY",
"task": {
"type": "CustomTask",
"class": "TenDI",
"websiteURL": "https://example.com",
"websiteKey": "189123456",
"userAgent": "userAgentPlaceholder"
}
}

Resposta

{
"errorId":0,
"taskId":407533072
}

Método de obter resultado da tarefa

Use o método getTaskResult para obter a solução do TenDI.

POST
https://api.capmonster.cloud/getTaskResult

Solicitação

{
"clientKey":"API_KEY",
"taskId": 407533072
}

Resposta

{
"errorId":0,
"status":"ready",
"solution": {
"data": {
"randstr": "@EcL",
"ticket": "tr03lHUhdnuW3neJZu.....7LrIbs*"
},
"headers": {
"User-Agent": "userAgentPlaceholder"
}
}
}

Como Encontrar Todos os Parâmetros Necessários para a Criação da Tarefa

Automaticamente

Uma forma conveniente de automatizar a busca por todos os parâmetros necessários.
Alguns parâmetros são regenerados a cada carregamento da página, então você precisará extraí-los através de um navegador — seja normal ou headless (por exemplo, usando Playwright).
Como os valores dos parâmetros dinâmicos são de curta duração, o captcha deve ser resolvido imediatamente após a captura deles.

Importante!

Os trechos de código fornecidos são exemplos básicos para familiarização com a extração dos parâmetros necessários. A implementação exata dependerá da sua página de captcha, sua estrutura e dos elementos/seletores HTML que ela utiliza.

Mostrar código (Node.js)
import { chromium } from "playwright";

(async () => {
const browser = await chromium.launch({ headless: false });
const page = await browser.newPage();

// Interceptar requisições
page.on("request", (request) => {
const url = request.url();
if (
url.startsWith("https://sg.captcha.qcloud.com/cap_union_prehandle?aid=")
) {
const parsedUrl = new URL(url);
const aid = parsedUrl.searchParams.get("aid");
console.log("Aid extraído:", aid);
}
});

await page.goto("https://www.example.com/", { waitUntil: "load" });

await page.waitForTimeout(5000);

await browser.close();
})();

Usar biblioteca SDK

// https://github.com/ZennoLab/capmonstercloud-client-js

import { CapMonsterCloudClientFactory, ClientOptions, TenDIRequest } from '@zennolab_com/capmonstercloud-client';

document.addEventListener('DOMContentLoaded', async () => {
const cmcClient = CapMonsterCloudClientFactory.Create(new ClientOptions({ clientKey: '<your capmonster.cloud API key>' }));
console.log(await cmcClient.getBalance());

const tenDIRequest = new TenDIRequest({
websiteURL: 'https://example.com',
websiteKey: 'websiteKey',
});

console.log(await cmcClient.Solve(tenDIRequest));
});