DocumentațieTeste de calificare
Teste de calificare externe
Îți poți rula testul de calificare pe propriul site. Lucrătorii urmează linkul tău, iar serverul tău îi spune TaskerData cine a promovat.
Cum funcționează
Calificarea ta de pe TaskerData conține doar instrucțiuni și un link. Fiecare lucrător primește un token personal. Pe site-ul tău, ceri acel token, rulezi testul, apoi apelezi API-ul nostru cu rezultatul. Lucrătorul este aprobat sau respins imediat.
Pasul 1: Configurează calificarea
Alege Întrebări
Creează o calificare nouă și lasă Tipul calificării la Întrebări. Șabloanele nu pot folosi o sursă externă.
Adaugă o Zonă de citat
Scrie instrucțiunile și include linkul către testul tău. Spune-le lucrătorilor să-și copieze ID-ul de token pe site-ul tău.
Nu adăuga întrebări cu răspuns
Opțiunea externă apare doar când nicio întrebare nu are răspuns Text, Casetă de bifare sau Buton radio și cel puțin o Zonă de citat conține un link.
Bifează opțiunea externă
Bifează Desfășoară calificarea folosind o sursă externă. Linkul API este furnizat după ce trimiți.
Alege lucrătorii și trimite
Setează targetarea și locurile ca de obicei. Poți adăuga un Bonus de calificare pentru lucrător pentru lucrătorii pe care îi aprobi.
Cost
Un test extern costă la fel ca o calificare obișnuită plus o Taxă pentru sursă externă de $1.00. Costul estimat de la pasul Verificare și trimitere arată totalul complet.
Pasul 2: Aprobare și configurare
După ce echipa noastră aprobă calificarea (solicitanții de încredere sunt aprobați automat), aceasta pornește pe pauză. Primești un mesaj: Calificare aprobată (configurare necesară). Lucrătorii încă nu o pot vedea.
Deschide calificarea și apasă Sursă externă și API pentru a vedea endpointul, cu ID-ul calificării și cheia API completate. Configurează-ți serverul, apoi apasă Reia calificarea pentru a o activa.
Tokenul lucrătorului
Când un lucrător deschide calificarea ta externă activă, TaskerData îi arată „ID-ul tău de token”. Tokenul aparține doar acelui lucrător și acelei calificări și rămâne același dacă reîncarcă pagina. Site-ul tău trebuie să-i ceară lucrătorului să-l introducă.
Pasul 3: Raportează rezultatul
De pe serverul tău, trimite o cerere GET la https://taskerdata.com/api/worker/external_qualification/data cu acești parametri de interogare:
| Parametru | Descriere |
|---|---|
| qualification_id | ID-ul calificării |
| worker_token | ID-ul de token introdus de lucrător pe site-ul tău |
| api_token | Cheia ta API |
| decision | approve sau reject |
Sfat: Apelează API-ul de pe serverul tău, nu din browserul lucrătorului, ca cheia API să rămână privată.
Reguli și mesaje de eroare
Un apel reușit returnează success true cu noua stare. Altfel primești success false și una dintre aceste erori:
- Missing required parameters: sunt necesari toți cei patru parametri.
- Decision must be approve or reject: decision trebuie să fie approve sau reject.
- Invalid API token sau API token does not belong to the qualification owner: cheia API este nevalidă sau nu aparține proprietarului calificării.
- Worker token not found for this qualification: tokenul lucrătorului nu a fost găsit pentru această calificare.
- This qualification is not configured for external submissions: această calificare nu este configurată pentru trimiteri externe.
- This qualification is no longer active: testele pe pauză, finalizate sau oprite nu acceptă rezultate.
- This worker has already been evaluated for this qualification: rezultatul fiecărui lucrător poate fi raportat o singură dată.
- Worker account is suspended: contul lucrătorului este suspendat.
- No remaining positions for this qualification: nu mai sunt locuri pentru această calificare.
Important: Dacă soldul tău nu acoperă bonusul unui lucrător aprobat, trimiterea este salvată ca în așteptare, iar răspunsul include o notă. Alimentează soldul și aprob-o din panou.
Testarea integrării
Pentru a testa fără să afectezi lucrători reali, trimite o cerere POST cu un corp JSON la https://taskerdata.com/api/worker/external_qualification/data_test. Folosește aceleași patru câmpuri, dar pune Cheia API de test în api_token.
Endpointul de test verifică doar că toate câmpurile sunt prezente, că decision este approve sau reject și că cheia de test este validă. Nu aprobă și nu respinge pe nimeni.
Chei API
Deschide secțiunea API din panou. Apasă Generează o cheie nouă pentru a-ți crea Cheia API și copiază Cheia API de test de pe aceeași pagină. Poți genera până la 3 chei noi pe oră.
O cheie nouă o înlocuiește pe cea veche. Dacă generezi o cheie nouă, actualizează codul serverului, altfel apelurile vor eșua cu Invalid API token.
Sfat: Toate detaliile tehnice se află pe pagina API, la /docs/api.
Întrebări frecvente
De ce este pe pauză calificarea mea aprobată?
Calificările externe pornesc pe pauză ca să-ți poți configura mai întâi serverul. Apasă Reia calificarea când ești gata.
Lucrătorii respinși consumă locuri?
Nu. Doar trimiterile aprobate și cele în așteptare se socotesc la locurile tale.
Pot schimba o decizie după ce am raportat-o?
API-ul acceptă un singur rezultat per lucrător. Un al doilea apel pentru același lucrător returnează o eroare.