createTask : criação de tarefa

Descrição

O método cria uma tarefa para resolver o tipo de captcha selecionado. Os parâmetros incluem dados de autenticação do cliente, informações tipadas da tarefa e, se necessário, parâmetros adicionais.

Endereço do método

https://api.capmonster.cloud/createTask

Formato da requisição: JSON POST

---

Parâmetros da requisição

clientKey

Type: String
Obrigatório: Sim
Chave única da sua conta, chave de API (pode ser encontrada aqui)

task

Type: Objeto da tarefa
Obrigatório: Sim
Array de dados da tarefa. Lista de tipos de tarefas de captcha aqui.

callbackUrl

Type: String
Obrigatório: Não
Endereço web para envio do resultado da tarefa de captcha. Os dados são enviados via 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 requisição em até 2 segundos, depois a conexão é encerrada.

Exemplo de uso do parâmetro callbackUrl:

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

---

Exemplos de requisições

Tarefa para resolver captcha de imagem simples

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

Tarefa para resolver 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

Type: Integer
Obrigatório: Sim
Identificador de erro.
0 - sem erros, tarefa criada com sucesso, o identificador da tarefa está no parâmetro taskId
1 - erro, informações detalhadas estão na propriedade errorCode

errorCode

Type: String
Obrigatório: Não
Código do erro. Veja o glossário de erros.

taskId

Type: Integer
Obrigatório: Sim
Identificador 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": "Account authorization key not found in the system or has incorrect format",
  "taskId": 0
}