api - descaptcha

Existe duas formas de enviar os captchas.
1. Enviar o Base64 da Imagem. Alguns sites (como para consulta de NF-e) já fornecem a imagem em Base64.
2. Enviar a imagem fazendo um HTTP Post, com Content-Type: multipart/form-data;

Primeiro o exemplo enviando a imagem com Base64.
O endereço para onde será feito o HTTP POST é http://api.descaptcha.com.br/envio/base64
O formato do envio pode ser json ou xml. Para escolher o formato, basta definir o Content-Type no cabeçalho HTTP.
Para JSON Content-Type: application/json
Para XML Content-Type: application/xml
Quando não informado, será assumido application/json, embora isso pode ser alterado no futuro, recomendamos sempre enviar o cabeçalho.

Documentação XML http://apidescaptcha.azurewebsites.net/xml/metadata?op=RecepcionarCaptchaBase64
Documentação JSON http://apidescaptcha.azurewebsites.net/json/metadata?op=RecepcionarCaptchaBase64
Documentação SOAP http://apidescaptcha.azurewebsites.net/soap12/metadata?op=RecepcionarCaptchaBase64

Os parâmetros enviados formam o objeto RecepcionarCaptchaBase64, com as seguintes propriedades:
 * ImagemBase64 - hash base64 da imagem
 * Chave - A chave do seu cadastro, que nós lhe enviamos
 * Tamanho - Tamanho do captcha, ou seja, quantas letras ou números o captcha possui. Esse campo é opcional.

Para fazer o upload da imagem sem utilizar Base64, deve-se fazer um HTTP POST para http://api.descaptcha.com.br/envio/
O POST deverá ser conforme o abaixo - exemplo utilizando HTML:

<form method="post" action="http://api.descaptcha.com.br/envio" enctype="multipart/form-data">
<input type="text" name="chave" value="a_chave_que_lhe_enviamos">
<input type="text" name="tamanho" value="tamanho_captcha_quando_possivel">
<input type="file" name="arquivo">
</form>

Independente da forma de envio, o resultado será sempre a mesma estrutura, conforme abaixo.
A resposta será um RecepcionarCaptchaResponse, com as seguintes propriedades:
 * CaptchaAceita: true/false - Indica se o seu captcha foi aceito pelo nosso sistema
 * IdCaptcha: Quando o captcha for aceito, esse será um campo com o Id que você usará para consultar posteriormente
 * Erro: Quando não for possível receber sua requisição, dentro da estrutura de erro irá informar um código e o motivo. A estrutura de erro possui dentro duas propriedades Codigo e Mensagem

Após obter o IdCaptcha, você deve aguardar 15 segundos e realizar um HTTP GET para
http://api.descaptcha.com.br?Chave=chave_que_lhe_enviamos&IdCaptcha=valor_IdCaptcha_retornado_no_envio_do_captcha

Documentação JSON http://apidescaptcha.azurewebsites.net/json/metadata?op=ResponderCaptcha
Documentação XML http://apidescaptcha.azurewebsites.net/xml/metadata?op=ResponderCaptcha

O resultado dessa chamada será uma estrutura ResponderCaptchaResponse com as seguintes propriedades
 * ResultadoProcessamento - Os valores possíveis são
    0 - ConsulteNovamente - Você deve refazer o HTTP GET, pois ainda não terminamos o processamento
        1 - Sucesso - Captcha resolvido, verifique a propriedade Resposta para obter o captcha resolvido
        2 - NaoFoiPossivelResponder  - Não conseguimos resolver o captcha. Entre em contato e verificaremos o que ocorreu.
        3- Erro - Houve um erro ao resolver o captcha. Entre em contato e verificaremos o que ocorreu.
 * Resposta - Resposta do captcha, preenchido apenas quando ResultadoProcessamento for 1
 * Erro - mesma estrutura de Erro do envio do captcha. Possui as propriedades Codigo e Mensagem