DokumentasiTes kualifikasi
Tes kualifikasi eksternal
Anda bisa menjalankan tes kualifikasi di situs web Anda sendiri. Pekerja mengikuti tautan Anda, lalu server Anda memberi tahu TaskerData siapa yang lulus.
Cara kerjanya
Kualifikasi Anda di TaskerData hanya berisi instruksi dan tautan. Setiap pekerja mendapat token pribadi. Di situs Anda, mintalah token itu, jalankan tes Anda, lalu panggil API kami dengan hasilnya. Pekerja langsung disetujui atau ditolak.
Langkah 1: Siapkan kualifikasi
Pilih Pertanyaan
Buat kualifikasi baru dan biarkan Jenis Kualifikasi tetap Pertanyaan. Template tidak bisa memakai sumber eksternal.
Tambahkan Area Kutipan
Tulis instruksi Anda dan sertakan tautan ke tes Anda. Minta pekerja menyalin ID Token mereka ke situs Anda.
Jangan tambahkan pertanyaan berjawaban
Opsi eksternal hanya muncul jika tidak ada pertanyaan dengan jawaban Teks, Kotak centang, atau Pilihan tunggal, dan minimal satu Area Kutipan berisi tautan.
Centang opsi eksternal
Centang Lakukan kualifikasi melalui sumber eksternal. Tautan API diberikan setelah Anda mengirim.
Pilih pekerja dan kirim
Atur penargetan dan posisi seperti biasa. Anda bisa menambahkan Bonus Kualifikasi Pekerja untuk pekerja yang Anda setujui.
Biaya
Tes eksternal berbiaya sama dengan kualifikasi biasa ditambah Biaya Sumber Eksternal sebesar $1.00. Perkiraan biaya di langkah Tinjau & kirim menampilkan total lengkapnya.
Langkah 2: Persetujuan dan pengaturan
Setelah tim kami menyetujui kualifikasi (pemberi tugas tepercaya disetujui otomatis), kualifikasi dimulai dalam keadaan dijeda. Anda menerima pesan: Qualification Approved (Setup Required), yang berarti kualifikasi disetujui dan perlu disiapkan. Pekerja belum bisa melihatnya.
Buka kualifikasi dan klik Sumber eksternal & API untuk melihat endpoint Anda, lengkap dengan ID kualifikasi dan kunci API Anda. Siapkan server Anda, lalu klik Lanjutkan kualifikasi untuk menayangkannya.
Token pekerja
Saat pekerja membuka kualifikasi eksternal Anda yang aktif, TaskerData menampilkan ID Token Anda kepada mereka. Token itu hanya milik pekerja tersebut dan kualifikasi tersebut, dan tetap sama meskipun halaman dimuat ulang. Situs web Anda harus meminta pekerja memasukkannya.
Langkah 3: Laporkan hasilnya
Dari server Anda, kirim permintaan GET ke https://taskerdata.com/api/worker/external_qualification/data dengan parameter query berikut:
| Parameter | Deskripsi |
|---|---|
| qualification_id | ID kualifikasi |
| worker_token | ID Token yang dimasukkan pekerja di situs Anda |
| api_token | Kunci API Anda |
| decision | approve atau reject |
Tips: Panggil API dari server Anda, bukan dari browser pekerja, agar kunci API Anda tetap rahasia.
Aturan dan pesan error
Panggilan yang berhasil mengembalikan success true beserta status barunya. Jika tidak, Anda mendapat success false dan salah satu error berikut:
- Missing required parameters: keempat parameter wajib ada.
- Decision must be 'approve' or 'reject': decision harus approve atau reject.
- Invalid API token, atau API token does not belong to the qualification owner: kunci API salah atau bukan milik pemilik kualifikasi.
- Worker token not found for this qualification: token pekerja tidak ditemukan untuk kualifikasi ini.
- This qualification is not configured for external submissions: kualifikasi ini tidak diatur untuk kiriman eksternal.
- This qualification is no longer active: tes yang dijeda, selesai, atau dihentikan tidak menerima hasil.
- This worker has already been evaluated for this qualification: setiap pekerja hanya bisa dilaporkan sekali.
- Worker account is suspended: akun pekerja ditangguhkan.
- No remaining positions for this qualification: tidak ada posisi tersisa untuk kualifikasi ini.
Penting: Jika saldo Anda tidak cukup untuk bonus pekerja yang disetujui, kiriman disimpan dengan status menunggu dan responsnya menyertakan catatan. Isi saldo lalu setujui kiriman itu di dasbor.
Menguji integrasi Anda
Untuk menguji tanpa memengaruhi pekerja sungguhan, kirim permintaan POST dengan body JSON ke https://taskerdata.com/api/worker/external_qualification/data_test. Gunakan empat kolom yang sama, tetapi isi api_token dengan Kunci API Uji Anda.
Endpoint uji hanya memeriksa bahwa kolom-kolomnya ada, bahwa decision bernilai approve atau reject, dan bahwa kunci ujinya valid. Endpoint ini tidak menyetujui atau menolak siapa pun.
Kunci API
Buka bagian API di dasbor Anda. Klik Buat Kunci Baru untuk membuat Kunci API Anda, dan salin Kunci API Uji dari halaman yang sama. Anda bisa membuat hingga 3 kunci baru per jam.
Kunci baru menggantikan kunci lama. Jika Anda membuat kunci baru, perbarui kode server Anda, atau panggilan Anda akan gagal dengan Invalid API token.
Tips: Detail teknis lengkap ada di halaman API di /docs/api.
Pertanyaan umum
Mengapa kualifikasi saya yang sudah disetujui dalam keadaan dijeda?
Kualifikasi eksternal dimulai dalam keadaan dijeda agar Anda bisa menyiapkan server terlebih dahulu. Klik Lanjutkan kualifikasi jika sudah siap.
Apakah pekerja yang ditolak memakai posisi?
Tidak. Hanya kiriman yang disetujui dan menunggu yang dihitung dalam posisi Anda.
Bisakah saya mengubah keputusan setelah melaporkannya?
API hanya menerima satu hasil per pekerja. Panggilan kedua untuk pekerja yang sama akan mengembalikan error.