Limites, tempos e cobrança

Limites de requisições, com que frequência consultar resultados, o tempo limite e quando há cobrança.

Limites de requisições

Até 1.200 requisições por minuto por conta (todas as chaves juntas, consultas de resultado incluídas) e até 2.400 por minuto de um mesmo endereço IP. Acima disso a resposta é ERROR_TOO_MANY_REQUESTS; aguarde alguns segundos e continue.

Com que frequência consultar

Aguarde cerca de 5 segundos depois de createTask e chame getTaskResult a cada 5 segundos. Para consultar muitas tarefas de uma vez com a API de formulário, use res.php com ids (até 100 ids em uma requisição). Para não precisar consultar, use um callback ou getToken.

res.php

curl -s "https://unlock-api.com/res.php?key=YOUR_API_KEY&action=get&ids=1001,1002,1003"
# 03AGdBq25SxXT...|CAPCHA_NOT_READY|ERROR_CAPTCHA_UNSOLVABLE

Tempo limite

Uma tarefa não resolvida em 5 minutos falha com ERROR_CAPTCHA_UNSOLVABLE. Os tokens expiram no site de destino pouco tempo depois (cerca de 2 minutos para reCAPTCHA), então use-os logo depois de recebê-los.

Quando há cobrança

O preço é descontado do saldo quando createTask aceita a tarefa. Se a tarefa falhar ou o tempo acabar, o preço total volta para o saldo automaticamente. Requisições recusadas com erro são gratuitas. getBalance, getTaskResult e os outros métodos de leitura são gratuitos.

O que guardamos

Imagens, áudio e dados de proxy enviados com uma tarefa são apagados quando a tarefa termina. O registro da tarefa (tipo, horário, status, custo) fica no seu histórico de tarefas.