DokumentasjonKvalifiseringstester
Eksterne kvalifiseringstester
Du kan kjøre kvalifiseringstesten din på ditt eget nettsted. Arbeiderne følger lenken din, og serveren din forteller TaskerData hvem som besto.
Slik fungerer det
Kvalifiseringen din på TaskerData inneholder bare instruksjoner og en lenke. Hver arbeider får et personlig token. På nettstedet ditt ber du om dette tokenet, kjører testen din og kaller deretter API-et vårt med resultatet. Arbeideren godkjennes eller avvises med en gang.
Trinn 1: Sett opp kvalifiseringen
Velg Spørsmål
Opprett en ny kvalifisering og behold Kvalifiseringstype som Spørsmål. Maler kan ikke bruke en ekstern kilde.
Legg til et Sitatområde
Skriv instruksjonene dine og ta med lenken til testen din. Be arbeiderne kopiere Token-ID-en sin inn på nettstedet ditt.
Ikke legg til spørsmål med svar
Det eksterne alternativet vises bare når ingen spørsmål har svartypen Tekst, Avkrysningsboks eller Alternativknapp, og minst ett Sitatområde inneholder en lenke.
Kryss av for det eksterne alternativet
Kryss av for Gjennomfør kvalifiseringen med ekstern kilde. API-lenken blir oppgitt etter at du har sendt inn.
Velg arbeidere og send inn
Angi målretting og plasser som vanlig. Du kan legge til en Kvalifiseringsbonus for arbeidere du godkjenner.
Kostnad
En ekstern test koster det samme som en vanlig kvalifisering pluss et Gebyr for ekstern kilde på $1.00. Beregnet kostnad i trinnet Gjennomgå og send inn viser hele totalen.
Trinn 2: Godkjenning og oppsett
Etter at teamet vårt har godkjent kvalifiseringen (pålitelige oppdragsgivere godkjennes automatisk), starter den satt på pause. Du får en melding: Kvalifisering godkjent (oppsett kreves). Arbeiderne kan ikke se den ennå.
Åpne kvalifiseringen og klikk på Ekstern kilde og API for å se endepunktet ditt, med kvalifiserings-ID-en og API-nøkkelen din fylt inn. Sett opp serveren din, og klikk deretter på Gjenoppta kvalifiseringen for å gjøre den aktiv.
Arbeidertokenet
Når en arbeider åpner den aktive eksterne kvalifiseringen din, viser TaskerData vedkommende Token-ID-en din. Tokenet tilhører bare den arbeideren og den kvalifiseringen, og forblir det samme hvis siden lastes inn på nytt. Nettstedet ditt må be arbeideren om å skrive det inn.
Trinn 3: Rapporter resultatet
Fra serveren din sender du en GET-forespørsel til https://taskerdata.com/api/worker/external_qualification/data med disse spørringsparameterne:
| Parameter | Beskrivelse |
|---|---|
| qualification_id | ID-en til kvalifiseringen |
| worker_token | Token-ID-en arbeideren skrev inn på nettstedet ditt |
| api_token | API-nøkkelen din |
| decision | approve eller reject |
Tips: Kall API-et fra serveren din, ikke fra arbeiderens nettleser, slik at API-nøkkelen din forblir privat.
Regler og feilmeldinger
Et vellykket kall returnerer success true med den nye statusen. Ellers får du success false og én av disse feilene:
- Missing required parameters: alle de fire parameterne kreves.
- Decision must be approve or reject: decision må være approve eller reject.
- Invalid API token eller API token does not belong to the qualification owner: API-nøkkelen er ugyldig eller tilhører ikke eieren av kvalifiseringen.
- Worker token not found for this qualification: arbeidertokenet ble ikke funnet for denne kvalifiseringen.
- This qualification is not configured for external submissions: denne kvalifiseringen er ikke satt opp for eksterne innsendinger.
- This qualification is no longer active: tester som er satt på pause, fullført eller stoppet, tar ikke imot resultater.
- This worker has already been evaluated for this qualification: resultatet for hver arbeider kan bare rapporteres én gang.
- Worker account is suspended: arbeiderkontoen er suspendert.
- No remaining positions for this qualification: det er ingen ledige plasser igjen for denne kvalifiseringen.
Viktig: Hvis saldoen din ikke dekker bonusen til en godkjent arbeider, lagres innsendingen i stedet som ventende, og svaret inneholder en merknad. Fyll på saldoen og godkjenn den på dashbordet.
Test integrasjonen din
For å teste uten å påvirke ekte arbeidere sender du en POST-forespørsel med en JSON-body til https://taskerdata.com/api/worker/external_qualification/data_test. Bruk de samme fire feltene, men legg Test-API-nøkkelen din i api_token.
Testendepunktet sjekker bare at feltene finnes, at decision er approve eller reject, og at testnøkkelen er gyldig. Det godkjenner eller avviser ingen.
API-nøkler
Åpne API-delen av dashbordet ditt. Klikk på Generer ny nøkkel for å opprette API-nøkkelen din, og kopier Test-API-nøkkelen fra samme side. Du kan generere opptil 3 nye nøkler per time.
En ny nøkkel erstatter den gamle. Hvis du genererer en ny nøkkel, må du oppdatere serverkoden din, ellers mislykkes kallene med Invalid API token.
Tips: Alle tekniske detaljer finner du på API-siden på /docs/api.
Vanlige spørsmål
Hvorfor er den godkjente kvalifiseringen min satt på pause?
Eksterne kvalifiseringer starter satt på pause, slik at du kan sette opp serveren din først. Klikk på Gjenoppta kvalifiseringen når du er klar.
Bruker avviste arbeidere opp plasser?
Nei. Bare godkjente og ventende innsendinger teller med i plassene dine.
Kan jeg endre en avgjørelse etter at jeg har rapportert den?
API-et tar imot ett resultat per arbeider. Et nytt kall for samme arbeider returnerer en feil.