DokumentacijaKvalifikacijos testai
Išoriniai kvalifikacijos testai
Kvalifikacijos testą galite vykdyti savo svetainėje. Darbuotojai atidaro jūsų nuorodą, o jūsų serveris praneša „TaskerData“, kas išlaikė.
Kaip tai veikia
Jūsų kvalifikacijoje „TaskerData“ yra tik instrukcijos ir nuoroda. Kiekvienas darbuotojas gauna asmeninį žetoną. Savo svetainėje paprašote to žetono, vykdote testą, tada iškviečiate mūsų API su rezultatu. Darbuotojas iš karto patvirtinamas arba atmetamas.
1 žingsnis: nustatykite kvalifikaciją
Pasirinkite „Klausimai“
Sukurkite naują kvalifikaciją ir palikite kvalifikacijos tipą „Klausimai“. Šablonai negali naudoti išorinio šaltinio.
Pridėkite citatos sritį
Parašykite instrukcijas ir įtraukite nuorodą į testą. Paprašykite darbuotojų nukopijuoti savo žetono ID į jūsų svetainę.
Nepridėkite klausimų su atsakymais
Išorinė parinktis atsiranda tik tada, kai nė vienas klausimas neturi atsakymo tekstu, žymimaisiais langeliais ar vienu pasirinkimu, o bent vienoje citatos srityje yra nuoroda.
Pažymėkite išorinę parinktį
Pažymėkite „Kvalifikaciją vykdyti išoriniame šaltinyje“. API nuoroda pateikiama po pateikimo.
Pasirinkite darbuotojus ir pateikite
Nustatykite taikymą ir vietas kaip įprastai. Galite pridėti darbuotojo kvalifikacijos premiją jūsų patvirtintiems darbuotojams.
Kaina
Išorinis testas kainuoja tiek pat kiek įprasta kvalifikacija plius 1,00 $ išorinio šaltinio mokestis. „Numatoma kaina“ žingsnyje „Peržiūra ir pateikimas“ rodo visą sumą.
2 žingsnis: patvirtinimas ir nustatymai
Mūsų komandai patvirtinus kvalifikaciją (patikimų užsakovų patvirtinamos automatiškai), ji pradedama pristabdyta. Gaunate žinutę: „Kvalifikacija patvirtinta (reikia nustatymų)“. Darbuotojai jos dar nemato.
Atidarykite kvalifikaciją ir spustelėkite „Išorinis šaltinis ir API“, kad pamatytumėte savo galinį tašką su užpildytu kvalifikacijos ID ir API raktu. Nustatykite savo serverį, tada spustelėkite „Tęsti kvalifikaciją“, kad ji būtų paskelbta.
Darbuotojo žetonas
Kai darbuotojas atidaro jūsų aktyvią išorinę kvalifikaciją, „TaskerData“ jam parodo „Jūsų žetono ID“. Žetonas priklauso tik tam darbuotojui ir tai kvalifikacijai ir nesikeičia perkrovus puslapį. Jūsų svetainė turi paprašyti darbuotojo jį įvesti.
3 žingsnis: praneškite rezultatą
Iš savo serverio išsiųskite GET užklausą adresu https://taskerdata.com/api/worker/external_qualification/data su šiais užklausos parametrais:
| Parametras | Aprašymas |
|---|---|
| qualification_id | Kvalifikacijos ID |
| worker_token | Žetono ID, kurį darbuotojas įvedė jūsų svetainėje |
| api_token | Jūsų API raktas |
| decision | approve arba reject |
Patarimas: API kvieskite iš savo serverio, o ne iš darbuotojo naršyklės, kad jūsų API raktas liktų privatus.
Taisyklės ir klaidų pranešimai
Sėkmingas iškvietimas grąžina success true ir naują būseną. Kitu atveju gaunate success false ir vieną iš šių klaidų (API jas grąžina anglų kalba):
- Missing required parameters: reikalingi visi keturi parametrai.
- Decision must be approve or reject: sprendimas turi būti approve arba reject.
- Invalid API token arba API token does not belong to the qualification owner: netinkamas API raktas arba jis nepriklauso kvalifikacijos savininkui.
- Worker token not found for this qualification: šios kvalifikacijos darbuotojo žetonas nerastas.
- This qualification is not configured for external submissions: kvalifikacija nenustatyta išoriniams pateikimams.
- This qualification is no longer active: pristabdyti, baigti ar sustabdyti testai rezultatų nepriima.
- This worker has already been evaluated for this qualification: kiekvieno darbuotojo rezultatą galima pranešti vieną kartą.
- Worker account is suspended: darbuotojo paskyra sustabdyta.
- No remaining positions for this qualification: šioje kvalifikacijoje laisvų vietų neliko.
Svarbu: Jei jūsų likutis negali padengti patvirtinto darbuotojo premijos, pateikimas išsaugomas kaip laukiantis, o atsakyme pateikiama pastaba. Papildykite likutį ir patvirtinkite jį skydelyje.
Integracijos testavimas
Norėdami išbandyti nepaveikdami tikrų darbuotojų, išsiųskite POST užklausą su JSON turiniu adresu https://taskerdata.com/api/worker/external_qualification/data_test. Naudokite tuos pačius keturis laukus, tik į api_token įrašykite savo bandomąjį API raktą.
Bandomasis galinis taškas tik patikrina, ar laukai pateikti, ar decision yra approve arba reject ir ar bandomasis raktas galioja. Jis nieko netvirtina ir neatmeta.
API raktai
Atidarykite skydelio skiltį „API“. Spustelėkite „Sukurti naują raktą“, kad sukurtumėte API raktą, o bandomąjį API raktą nukopijuokite iš to paties puslapio. Per valandą galite sukurti iki 3 naujų raktų.
Naujas raktas pakeičia senąjį. Jei sukuriate naują raktą, atnaujinkite serverio kodą, kitaip iškvietimai nepavyks su klaida Invalid API token.
Patarimas: Visa techninė informacija pateikta API puslapyje adresu /docs/api.
Dažni klausimai
Kodėl mano patvirtinta kvalifikacija pristabdyta?
Išorinės kvalifikacijos pradedamos pristabdytos, kad pirmiausia galėtumėte nustatyti savo serverį. Kai būsite pasiruošę, spustelėkite „Tęsti kvalifikaciją“.
Ar atmesti darbuotojai užima vietas?
Ne. Į jūsų vietas įskaičiuojami tik patvirtinti ir laukiantys pateikimai.
Ar galiu pakeisti sprendimą jį pranešęs?
API priima vieną rezultatą vienam darbuotojui. Antras iškvietimas tam pačiam darbuotojui grąžina klaidą.