DokumentationKvalifikationstest
Externa kvalifikationstest
Du kan köra ditt kvalifikationstest på din egen webbplats. Arbetarna följer din länk, och din server meddelar TaskerData vem som klarade sig.
Så fungerar det
Ditt kvalifikationstest på TaskerData innehåller bara instruktioner och en länk. Varje arbetare får en personlig token. På din webbplats ber du om den token, kör ditt test och anropar sedan vårt API med resultatet. Arbetaren godkänns eller avvisas direkt.
Steg 1: Konfigurera kvalifikationstestet
Välj Frågor
Skapa ett nytt kvalifikationstest och låt kvalifikationstypen vara Frågor. Mallar kan inte använda en extern källa.
Lägg till ett citatblock
Skriv dina instruktioner och ta med länken till ditt test. Be arbetarna kopiera sitt token-ID till din webbplats.
Lägg inte till frågor med svar
Det externa alternativet visas bara när ingen fråga har svarstypen Text, Kryssruta eller Radioknapp och minst ett citatblock innehåller en länk.
Kryssa i det externa alternativet
Kryssa i Genomför kvalifikationstestet via extern källa. API-länken visas när du har skickat in.
Välj arbetare och skicka in
Ställ in målgrupp och platser som vanligt. Du kan lägga till en kvalifikationsbonus för arbetare som du godkänner.
Kostnad
Ett externt test kostar lika mycket som ett vanligt kvalifikationstest plus en avgift för extern källa på $1.00. Beräknad kostnad i steget Granska och skicka visar hela totalen.
Steg 2: Godkännande och konfiguration
När vårt team har godkänt kvalifikationstestet (betrodda uppdragsgivare godkänns automatiskt) startar det pausat. Du får meddelandet: Kvalifikationstest godkänt (konfiguration krävs). Arbetarna kan inte se det ännu.
Öppna kvalifikationstestet och klicka på Extern källa och API för att se din endpoint, med ditt kvalifikations-ID och din API-nyckel ifyllda. Konfigurera din server och klicka sedan på Återuppta kvalifikationstest för att publicera det.
Arbetarens token
När en arbetare öppnar ditt aktiva externa kvalifikationstest visar TaskerData Ditt token-ID. Token tillhör bara den arbetaren och det kvalifikationstestet, och förblir densamma om hen laddar om sidan. Din webbplats måste be arbetaren ange den.
Steg 3: Rapportera resultatet
Skicka från din server en GET-förfrågan till https://taskerdata.com/api/worker/external_qualification/data med dessa frågeparametrar:
| Parameter | Beskrivning |
|---|---|
| qualification_id | Kvalifikationstestets ID |
| worker_token | Det token-ID som arbetaren angav på din webbplats |
| api_token | Din API-nyckel |
| decision | approve eller reject |
Tips: Anropa API:t från din server, inte från arbetarens webbläsare, så att din API-nyckel förblir privat.
Regler och felmeddelanden
Ett lyckat anrop returnerar success true med den nya statusen. Annars får du success false och ett av dessa fel:
- Missing required parameters: alla fyra parametrar krävs.
- Decision must be approve or reject.
- Invalid API token, eller API token does not belong to the qualification owner.
- Worker token not found for this qualification.
- This qualification is not configured for external submissions.
- This qualification is no longer active: pausade, slutförda eller stoppade test tar inte emot resultat.
- This worker has already been evaluated for this qualification: varje arbetare kan bara rapporteras en gång.
- Worker account is suspended.
- No remaining positions for this qualification.
Viktigt: Om ditt saldo inte räcker till bonusen för en godkänd arbetare sparas inlämningen som väntande i stället och svaret innehåller en anteckning. Fyll på och godkänn den i panelen.
Testa din integration
För att testa utan att påverka riktiga arbetare skickar du en POST-förfrågan med en JSON-body till https://taskerdata.com/api/worker/external_qualification/data_test. Använd samma fyra fält, men ange din test-API-nyckel i api_token.
Testendpointen kontrollerar bara att fälten finns, att decision är approve eller reject och att testnyckeln är giltig. Den godkänner eller avvisar ingen.
API-nycklar
Öppna avsnittet API i din panel. Klicka på Generera ny nyckel för att skapa din API-nyckel, och kopiera din test-API-nyckel från samma sida. Du kan generera upp till 3 nya nycklar per timme.
En ny nyckel ersätter den gamla. Om du genererar en ny nyckel, uppdatera din serverkod, annars misslyckas dina anrop med Invalid API token.
Tips: Alla tekniska detaljer finns på API-sidan på /docs/api.
Vanliga frågor
Varför är mitt godkända kvalifikationstest pausat?
Externa kvalifikationstest startar pausade så att du kan konfigurera din server först. Klicka på Återuppta kvalifikationstest när du är redo.
Förbrukar avvisade arbetare platser?
Nej. Bara godkända och väntande inlämningar räknas mot dina platser.
Kan jag ändra ett beslut efter att jag rapporterat det?
API:t tar emot ett resultat per arbetare. Ett andra anrop för samma arbetare returnerar ett fel.