DocumentaçãoTestes de qualificação
Testes de qualificação externos
Você pode aplicar o seu teste de qualificação no seu próprio site. Os trabalhadores seguem o seu link, e o seu servidor informa à TaskerData quem foi aprovado.
Como funciona
Sua qualificação na TaskerData contém apenas instruções e um link. Cada trabalhador recebe um token pessoal. No seu site, você pede esse token, aplica o teste e depois chama a nossa API com o resultado. O trabalhador é aprovado ou rejeitado na hora.
Etapa 1: Configure a qualificação
Escolha Perguntas
Crie uma nova qualificação e mantenha o Tipo de qualificação em Perguntas. Modelos não podem usar fonte externa.
Adicione uma Área de texto
Escreva suas instruções e inclua o link para o seu teste. Diga aos trabalhadores para copiar o ID de token deles no seu site.
Não adicione perguntas com resposta
A opção externa só aparece quando nenhuma pergunta tem resposta em Texto, Caixas de seleção ou Opção única e pelo menos uma Área de texto contém um link.
Marque a opção externa
Marque Realizar a qualificação com uma fonte externa. O link da API é fornecido depois do envio.
Escolha os trabalhadores e envie
Defina a segmentação e as vagas como de costume. Você pode adicionar um Bônus de qualificação para os trabalhadores que aprovar.
Custo
Um teste externo custa o mesmo que uma qualificação normal mais uma Taxa de fonte externa de $1.00. O Custo estimado na etapa Revisar e enviar mostra o total completo.
Etapa 2: Aprovação e configuração
Depois que nossa equipe aprova a qualificação (solicitantes confiáveis são aprovados automaticamente), ela começa pausada. Você recebe uma mensagem: Qualificação aprovada (configuração necessária). Os trabalhadores ainda não conseguem vê-la.
Abra a qualificação e clique em Fonte externa e API para ver o seu endpoint, com o ID da qualificação e a sua chave de API já preenchidos. Configure o seu servidor e depois clique em Retomar qualificação para entrar no ar.
O token do trabalhador
Quando um trabalhador abre a sua qualificação externa ativa, a TaskerData mostra a ele Seu ID de token. O token pertence somente àquele trabalhador e àquela qualificação, e continua o mesmo se ele recarregar a página. Seu site precisa pedir que o trabalhador o informe.
Etapa 3: Envie o resultado
A partir do seu servidor, envie uma requisição GET para https://taskerdata.com/api/worker/external_qualification/data com estes parâmetros de consulta:
| Parâmetro | Descrição |
|---|---|
| qualification_id | ID da qualificação |
| worker_token | O ID de token que o trabalhador informou no seu site |
| api_token | Sua chave de API |
| decision | approve ou reject |
Dica: Chame a API a partir do seu servidor, não do navegador do trabalhador, para que sua chave de API continue privada.
Regras e mensagens de erro
Uma chamada bem-sucedida retorna success true com o novo status. Caso contrário, você recebe success false e um destes erros:
- Missing required parameters: os quatro parâmetros são obrigatórios.
- Decision must be approve or reject: decision precisa ser approve ou reject.
- Invalid API token, ou API token does not belong to the qualification owner: a chave de API é inválida ou não pertence ao dono da qualificação.
- Worker token not found for this qualification: o token do trabalhador não foi encontrado para esta qualificação.
- This qualification is not configured for external submissions: a qualificação não está configurada para envios externos.
- This qualification is no longer active: testes pausados, concluídos ou interrompidos não aceitam resultados.
- This worker has already been evaluated for this qualification: cada trabalhador só pode ser informado uma vez.
- Worker account is suspended: a conta do trabalhador está suspensa.
- No remaining positions for this qualification: não restam vagas nesta qualificação.
Importante: Se o seu saldo não cobrir o bônus de um trabalhador aprovado, o envio fica salvo como pendente e a resposta inclui um aviso. Recarregue o saldo e aprove-o no painel.
Testar sua integração
Para testar sem afetar trabalhadores reais, envie uma requisição POST com um corpo JSON para https://taskerdata.com/api/worker/external_qualification/data_test. Use os mesmos quatro campos, mas coloque a sua Chave de API de teste em api_token.
O endpoint de teste só verifica se os campos estão presentes, se decision é approve ou reject e se a chave de teste é válida. Ele não aprova nem rejeita ninguém.
Chaves de API
Abra a seção API do seu painel. Clique em Gerar nova chave para criar sua Chave de API e copie sua Chave de API de teste na mesma página. Você pode gerar até 3 novas chaves por hora.
Uma nova chave substitui a antiga. Se você gerar uma nova chave, atualize o código do seu servidor, ou suas chamadas vão falhar com Invalid API token.
Dica: Todos os detalhes técnicos estão na página da API, em /docs/api.
Perguntas frequentes
Por que minha qualificação aprovada está pausada?
As qualificações externas começam pausadas para que você configure o seu servidor primeiro. Clique em Retomar qualificação quando estiver pronto.
Trabalhadores rejeitados ocupam vagas?
Não. Só os envios aprovados e pendentes contam para as suas vagas.
Posso mudar uma decisão depois de enviá-la?
A API aceita um resultado por trabalhador. Uma segunda chamada para o mesmo trabalhador retorna um erro.