Saltar para o conteúdo principal

​
Introdução

reCAPTCHA é um serviço de captcha fornecido pela Ace Data Cloud, uma solução do Google reCAPTCHA. Através da API unificada da Ace Data Cloud, você pode usar cURL para chamar rapidamente o reCAPTCHA, implementando funcionalidades como Token reCAPTCHA v2, reconhecimento reCAPTCHA v2, Token reCAPTCHA v3, entre outras.

​
Pré-requisitos

  • Possuir uma conta Ace Data Cloud e obter o API Token
  • Ter um ambiente de terminal com cURL instalado

​
Uso Básico

O endpoint principal para chamar a API reCAPTCHA é: 
POST https://api.acedata.cloud/captcha/token/recaptcha2
Exemplo completo de comando cURL: 
curl -X POST https://api.acedata.cloud/captcha/token/recaptcha2 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", "website_url": "https://www.google.com/recaptcha/api2/demo"}'
Por favor, substitua YOUR_API_TOKEN pelo Token real obtido na plataforma Ace Data Cloud.

​
Exemplo de Resposta

Após uma chamada bem-sucedida, será retornado um dado no formato JSON, por exemplo: 
{
  "status": "success",
  "data": {
    ...
  }
}

​
Usando jq para Processar a Resposta

Recomenda-se utilizar a ferramenta jq para formatar a saída: 
curl -s -X POST https://api.acedata.cloud/captcha/token/recaptcha2 \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"website_key": "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-", "website_url": "https://www.google.com/recaptcha/api2/demo"}' | jq .

​
Tratamento de Erros

Códigos de erro comuns:
CódigoDescrição
401Falha na autenticação, verifique o API Token
403Saldo insuficiente ou acesso negado
429Limite de frequência de requisições excedido
500Erro interno do servidor

​
Próximos Passos