Skip to main content
Este documento apresentará uma descrição da API de reconhecimento de captchas alfanuméricos, que é baseada em tecnologia de aprendizado profundo e pode ser usada para reconhecer captchas alfanuméricos de comprimento variável. A entrada é a imagem do captcha, e a saída é o resultado do captcha.

​
Processo de Solicitação

Para usar a API de reconhecimento de captchas alfanuméricos, primeiro acesse o Painel de Controle da Ace Data Cloud para obter seu Token da API, que deve ser guardado para uso futuro. Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e logar. Após a conclusão, você será redirecionado de volta para a página atual. Um Token da API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço. A primeira solicitação oferece um crédito gratuito para que você possa experimentar; quando o crédito acabar, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: API de Reconhecimento de Captchas Alfanuméricos →

​
Uso Básico

Primeiro, entenda a forma básica de uso, que é inserir a imagem do captcha alfanumérico de comprimento variável que precisa ser processada para obter o resultado processado. Primeiro, você precisa passar um campo image, que é a imagem do captcha alfanumérico, como mostrado na figura:

Em seguida, precisamos converter a imagem do captcha em uma codificação Base64. Para converter a codificação Base64, recomenda-se usar a extensão do Google Chrome FeHelper, e o método de uso específico pode ser consultado na imagem abaixo:

Depois, você pode copiar a codificação Base64 obtida pela extensão FeHelper, lembrando que não deve incluir o prefixo data:image/png;base64. O conteúdo específico é o seguinte:

Podemos ver que aqui configuramos os Headers da Requisição, incluindo:
  • accept: o formato de resposta desejado, que deve ser preenchido como application/json, ou seja, formato JSON.
  • authorization: a chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
Além disso, configuramos o Corpo da Requisição, incluindo:
  • image: a imagem do captcha codificada em Base64 (sem o prefixo data:image/png;base64).
Após a seleção, você pode notar que o código correspondente também foi gerado à direita, como mostrado na figura:

Clique no botão “Try” para realizar o teste, como mostrado na figura acima, e aqui obtemos o seguinte resultado:
O resultado retornado contém vários campos, descritos a seguir:
  • text: o conteúdo textual resultante do processamento da imagem do captcha alfanumérico.
  • started_at, finished_at: os horários de início e término do processamento desta solicitação, em timestamp Unix (segundos, ponto flutuante).
  • elapsed: o tempo total gasto no processamento (segundos).
Podemos ver que obtivemos o resultado da validação da imagem do captcha alfanumérico, e precisamos apenas verificar o conteúdo textual no campo text para passar na validação. Além disso, se você quiser gerar o código de integração correspondente, pode copiá-lo diretamente, por exemplo, o código CURL é o seguinte:
O código de integração em Python é o seguinte:

​
Modo Assíncrono (async)

Por padrão, a API é síncrona e bloqueante: uma solicitação aguardará até que o resultado do reconhecimento seja processado antes de retornar. Se você estiver fazendo uma rotação de múltiplos solucionadores (multi-solver rotation) e desejar “submeter a tarefa e imediatamente obter o task_id, para depois agendar outros solucionadores e retornar mais tarde para ler o resultado”, você pode passar async: true no corpo da solicitação. Ao passar async: true, a interface retornará imediatamente um task_id, sem bloquear a espera:
Se você quiser verificar o progresso ativamente, pode usar o task_id para consultar POST /captcha/tasks (recomendado a cada 3~5 segundos). Esta interface não acionará ou avançará o processamento da tarefa; mesmo que você não consulte, perca a conexão ou saia do cliente, o servidor continuará processando:
Durante o processamento, retornará status: processing:
Quando o processamento for concluído, retornará status: ready e o resultado do reconhecimento text (a estrutura dos campos é completamente idêntica ao modo síncrono):
Descrição da cobrança: no modo assíncrono, a criação de tarefas e a leitura do status “processando” não são cobradas; a cobrança ocorre uma vez quando o cliente lê o resultado com sucesso pela primeira vez (consistente com o comportamento atual e o preço do modo síncrono). O servidor avançará a tarefa por conta própria, mas não cobrará antecipadamente se a conclusão ocorrer no backend. Se a tarefa não for concluída com sucesso em 120 segundos, será encerrada com HTTP 504 timeout, sem cobrança. /captcha/tasks não é responsável por avançar a tarefa.

​
Tratamento de Erros

Ao chamar a API, se ocorrer um erro, a API retornará o código e a mensagem de erro correspondentes. Por exemplo:
  • 400 token_mismatched：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 400 api_not_implemented：Solicitação inválida, possivelmente devido a parâmetros ausentes ou inválidos.
  • 401 invalid_token：Não autorizado, token de autorização inválido ou ausente.
  • 429 too_many_requests：Muitas solicitações, você excedeu o limite de taxa.
  • 500 api_error：Erro interno do servidor, algo deu errado no servidor.

​
Exemplo de resposta de erro

​
Conclusão

Através deste documento, você já entendeu como usar a API de reconhecimento de código de verificação alfanumérico. Insira o conteúdo da imagem do código de verificação, e a saída será o resultado do código de verificação. Esperamos que este documento possa ajudá-lo a integrar e usar melhor essa API. Se tiver alguma dúvida, entre em contato com nossa equipe de suporte técnico.