createTask : criando uma tarefa

Descrição

Este método cria uma tarefa para resolver o tipo de captcha selecionado. Nos parâmetros, é necessário passar os dados de autorização do cliente, os dados da tarefa e outros parâmetros opcionais.

Endereço do método

https://api.capmonster.cloud/createTask

Formato da solicitação: JSON POST

---

Parâmetros da solicitação

clientKey

Tipo: String
Obrigatório: Sim
Sua chave de conta única, chave da API (Você pode encontrá-la aqui)

task

Tipo: Objeto Tarefa
Obrigatório: Sim
Array de dados da tarefa. Veja a lista de descrições de objetos disponíveis aqui.

callbackUrl

Tipo: String
Obrigatório: Não
Endereço web para o envio do resultado da tarefa do captcha. Os dados são enviados por solicitação POST.
O conteúdo é idêntico à resposta do método getTaskResult.
O conteúdo da resposta não é verificado, e o servidor deve aceitar a solicitação em 2 segundos; após isso, a conexão será encerrada.

Exemplo de uso da função callbackUrl:

{
  "clientKey": "API_KEY",
  "task": {
    "type": "NoCaptchaTaskProxyless",
    "websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
    "websiteKey": "6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
  },
  "callbackUrl": "https://yourwebsite.com/callback"
}

---

Exemplos de solicitação

Resolvendo captcha normal com uma imagem

    {
      "clientKey":"API_KEY",
      "task": 
      {
        "type":"ImageToTextTask",
        "body":"BASE64_BODY_HERE!"
      }
    }

Resolvendo ReCaptcha2

    {
      "clientKey":"API_KEY",
      "task": 
      {
        "type":"RecaptchaV2Task",
        "websiteURL":"https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
        "websiteKey":"6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
      }
    }

---

Estrutura da resposta

errorId

Tipo: Integer
Obrigatório: Sim
Identificador de erro.
0 - sem erros, a tarefa foi criada com sucesso, o ID da tarefa está localizado na propriedade taskId
1 - erro, as informações sobre ele estão na propriedade errorCode

errorCode

Tipo: String
Obrigatório: Não
Código de erro. Verifique a lista de erros.

taskId

Tipo: Integer
Obrigatório: Sim
ID da tarefa para uso posterior no método getTaskResult.

---

Exemplo de resposta

Resposta SEM erro

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

Resposta COM erro

    {
        "errorId": 1,
        "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
        "errorDescription": "Chave de autorização da conta não encontrada no sistema ou com formato incorreto",
        "taskId": 0
    }