DocumentazioneTest di qualifica
Test di qualifica esterni
Puoi svolgere il tuo test di qualifica sul tuo sito web. I lavoratori seguono il tuo link e il tuo server comunica a TaskerData chi lo ha superato.
Come funziona
Il tuo test di qualifica su TaskerData contiene solo istruzioni e un link. Ogni lavoratore riceve un token personale. Sul tuo sito chiedi quel token, svolgi il tuo test, poi chiami la nostra API con il risultato. Il lavoratore viene approvato o rifiutato subito.
Passaggio 1: Imposta il test di qualifica
Scegli Domande
Crea un nuovo test di qualifica e lascia il Tipo di test di qualifica su Domande. I modelli non possono usare una fonte esterna.
Aggiungi un'Area citazione
Scrivi le tue istruzioni e includi il link al tuo test. Di' ai lavoratori di copiare il loro ID token sul tuo sito.
Non aggiungere domande con risposta
L'opzione esterna compare solo quando nessuna domanda ha una risposta di tipo Testo, Casella di controllo o Pulsante di opzione e almeno un'Area citazione contiene un link.
Seleziona l'opzione esterna
Seleziona Svolgi il test di qualifica con una fonte esterna. Il link API viene fornito dopo l'invio.
Scegli i lavoratori e invia
Imposta targeting e posti come al solito. Puoi aggiungere un Bonus di qualifica per il lavoratore per i lavoratori che approvi.
Costo
Un test esterno costa quanto un normale test di qualifica più una Commissione per fonte esterna di $1.00. Il Costo stimato nel passaggio Controlla e invia mostra il totale completo.
Passaggio 2: Approvazione e configurazione
Dopo che il nostro team ha approvato il test di qualifica (i committenti affidabili vengono approvati automaticamente), parte in pausa. Ricevi un messaggio: Test di qualifica approvato (configurazione necessaria). I lavoratori non possono ancora vederlo.
Apri il test di qualifica e fai clic su Fonte esterna e API per vedere il tuo endpoint, con ID del test di qualifica e chiave API già compilati. Configura il tuo server, poi fai clic su Riprendi il test di qualifica per pubblicarlo.
Il token del lavoratore
Quando un lavoratore apre il tuo test di qualifica esterno attivo, TaskerData gli mostra Il tuo ID token. Il token appartiene solo a quel lavoratore e a quel test di qualifica, e resta lo stesso se ricarica la pagina. Il tuo sito web deve chiedere al lavoratore di inserirlo.
Passaggio 3: Comunica il risultato
Dal tuo server, invia una richiesta GET a https://taskerdata.com/api/worker/external_qualification/data con questi parametri di query:
| Parametro | Descrizione |
|---|---|
| qualification_id | ID del test di qualifica |
| worker_token | L'ID token che il lavoratore ha inserito sul tuo sito |
| api_token | La tua chiave API |
| decision | approve o reject |
Suggerimento: Chiama l'API dal tuo server, non dal browser del lavoratore, così la tua chiave API resta privata.
Regole e messaggi di errore
Una chiamata riuscita restituisce success true con il nuovo stato. Altrimenti ricevi success false e uno di questi errori:
- Missing required parameters: servono tutti e quattro i parametri.
- Decision must be approve or reject: decision deve essere approve o reject.
- Invalid API token oppure API token does not belong to the qualification owner: la chiave API non è valida o non appartiene al proprietario del test di qualifica.
- Worker token not found for this qualification: il token del lavoratore non è stato trovato per questo test di qualifica.
- This qualification is not configured for external submissions: questo test di qualifica non è configurato per invii esterni.
- This qualification is no longer active: i test in pausa, completati o interrotti non accettano risultati.
- This worker has already been evaluated for this qualification: il risultato di ogni lavoratore può essere comunicato una sola volta.
- Worker account is suspended: l'account del lavoratore è sospeso.
- No remaining positions for this qualification: non ci sono più posti liberi per questo test di qualifica.
Importante: Se il tuo saldo non copre il bonus di un lavoratore approvato, l'invio viene invece salvato come in attesa e la risposta include una nota. Ricarica il saldo e approvalo nella dashboard.
Testare l'integrazione
Per fare test senza coinvolgere lavoratori reali, invia una richiesta POST con un corpo JSON a https://taskerdata.com/api/worker/external_qualification/data_test. Usa gli stessi quattro campi, ma inserisci la tua Chiave API di test in api_token.
L'endpoint di test controlla solo che i campi siano presenti, che decision sia approve o reject e che la chiave di test sia valida. Non approva né rifiuta nessuno.
Chiavi API
Apri la sezione API della tua dashboard. Fai clic su Genera una nuova chiave per creare la tua Chiave API, e copia la tua Chiave API di test dalla stessa pagina. Puoi generare fino a 3 nuove chiavi all'ora.
Una nuova chiave sostituisce la precedente. Se generi una nuova chiave, aggiorna il codice del tuo server, altrimenti le tue chiamate falliranno con Invalid API token.
Suggerimento: I dettagli tecnici completi sono nella pagina API all'indirizzo /docs/api.
Domande frequenti
Perché il mio test di qualifica approvato è in pausa?
I test di qualifica esterni partono in pausa così puoi prima configurare il tuo server. Fai clic su Riprendi il test di qualifica quando sei pronto.
I lavoratori rifiutati occupano posti?
No. Solo gli invii approvati e in attesa contano nei tuoi posti.
Posso cambiare una decisione dopo averla comunicata?
L'API accetta un solo risultato per lavoratore. Una seconda chiamata per lo stesso lavoratore restituisce un errore.