Documentação da API ReCAPTCHA

Esta documentação descreve como utilizar a API ReCAPTCHA para obter respostas do Google ReCAPTCHA v2.

Get-balance

GET

http://191.96.78.161:3000/get-balance?token={SEU-TOKEN-SUPERCAPTCHA}

Este endpoint permite obter o saldo disponivel no token.

Endpoint

POST

/recaptcha/api2/anchor

Este endpoint permite obter a resposta do Google ReCAPTCHA v2 invisible.

Requisição

URL

http://191.96.78.161:3000/recaptcha/api2/anchor

Cabeçalhos (Headers)

"Content-Type: application/json"

Corpo da Requisição (Body)

A requisição deve ser enviada no formato JSON com os seguintes parâmetros:

Parâmetro Tipo Descrição

ar

 string Parâmetro do reCAPTCHA. Geralmente 1.

k

 string Chave do site reCAPTCHA (sitekey).

co

 string Código codificado em Base64 com informações da origem.

hl

 string Idioma do ReCAPTCHA (pt-BR, en, etc.).

v

 string Versão do reCAPTCHA.

size

 string Tipo do captcha (invisible, normal, etc.).

cb

 string Código gerado para identificação da requisição.

token

 string Chave de API necessária para validar o saldo antes de processar o request.

Exemplo de Body


{
  "ar": "1",
  "k": "6LfjD8gnAAAAAIa-vo6PLPXZDnMvtU5YSi3A_w9n",
  "co": "aHR0cHM6Ly9jb250YS1kaWdpdGFsLXBqLmludGVyLmNvOjQ0Mw..",
  "hl": "pt-BR",
  "v": "hbAq-YhJxOnlU-7cpgBoAJHb",
  "size": "invisible",
  "cb": "8qyxtvv9e5q1",
  "token": "CHAVE-API-SUPERCAPTCHA"
}

Respostas

A API retornará diferentes status de acordo com a situação:

200

Sucesso

Quando a solicitação for processada corretamente, a API retorna:

{ "captcha": "03AFcWeA610i4kNdnPPOBVQQ2SD0So0Z5fDb6DukicnlN..." }

400

Token não informado

Caso o token da API não seja enviado:

{ "error": "Token é obrigatório" }

404

Token inválido

Se o token não for encontrado no sistema:

{ "error": "Token inválido" }

403

Saldo insuficiente

Caso o saldo do token esteja abaixo do mínimo necessário:

{ "error": "Saldo insuficiente" }

500

Erro interno

Se houver falha ao buscar o saldo ou ao fazer a requisição ao Google:

{ "error": "Erro no banco de dados" }

ou

{ "error": "Erro ao obter CAPTCHA" }

Como Testar

Você pode testar essa API utilizando Postman, cURL ou diretamente no seu código.

Exemplo com cURL


curl -X POST "http://191.96.78.161:3000/recaptcha/api2/anchor" \
-H "Content-Type: application/json" \
-d '{
"ar": "1",
"k": "6LfjD8gnAAAAAIa-vo6PLPXZDnMvtU5YSi3A_w9n",
"co": "aHR0cHM6Ly9jb250YS1kaWdpdGFsLXBqLmludGVyLmNvOjQ0Mw..",
"hl": "pt-BR",
"v": "hbAq-YhJxOnlU-7cpgBoAJHb",
"size": "invisible",
"cb": "8qyxtvv9e5q1",
"token": "CHAVE-API-SUPERCAPTCHA"
}'

Suporte

Caso tenha dúvidas ou problemas, entre em contato com o suporte.