BelgelerYeterlilik testleri
Harici yeterlilik testleri
Yeterlilik testini kendi web sitende yürütebilirsin. Çalışanlar bağlantını izler ve sunucun TaskerData'ya kimin geçtiğini söyler.
Nasıl çalışır
TaskerData'daki yeterliliğin yalnızca talimatları ve bir bağlantıyı içerir. Her çalışan kişisel bir token alır. Sitende o token'ı ister, testini yürütür, ardından sonuçla API'mizi çağırırsın. Çalışan hemen onaylanır veya reddedilir.
1. adım: Yeterliliği ayarla
Sorular'ı seç
Yeni bir yeterlilik oluştur ve Yeterlilik Türü'nü Sorular olarak bırak. Şablonlar harici kaynak kullanamaz.
Bir Alıntı Alanı ekle
Talimatlarını yaz ve testinin bağlantısını ekle. Çalışanlara Token ID'lerini sitene kopyalamalarını söyle.
Yanıt sorusu ekleme
Harici seçenek yalnızca hiçbir soruda Metin, Onay kutusu veya Seçenek düğmesi yanıtı olmadığında ve en az bir Alıntı Alanı bir bağlantı içerdiğinde görünür.
Harici seçeneği işaretle
Yeterliliği harici bir kaynakla yürüt seçeneğini işaretle. API bağlantısı gönderdikten sonra verilir.
Çalışanları seç ve gönder
Hedeflemeyi ve kontenjanı her zamanki gibi ayarla. Onayladığın çalışanlar için bir Çalışan Yeterlilik Bonusu ekleyebilirsin.
Maliyet
Harici bir test, normal bir yeterlilikle aynı tutara artı 1,00 $ Harici Kaynak Ücreti'ne mal olur. Gözden geçir ve gönder adımındaki Tahmini maliyet tam toplamı gösterir.
2. adım: Onay ve kurulum
Ekibimiz yeterliliği onayladıktan sonra (güvenilir işverenler otomatik olarak onaylanır) yeterlilik duraklatılmış olarak başlar. Yeterliliğin onaylandığını ve kurulum gerektiğini belirten bir mesaj alırsın. Çalışanlar onu henüz göremez.
Yeterlilik ID'n ve API anahtarın doldurulmuş olarak uç noktanı görmek için yeterliliği aç ve Harici kaynak ve API'ye tıkla. Sunucunu kur, ardından yayına almak için Yeterliliği sürdür'e tıkla.
Çalışan token'ı
Bir çalışan aktif harici yeterliliğini açtığında TaskerData ona Token ID'n bilgisini gösterir. Token yalnızca o çalışana ve o yeterliliğe aittir ve sayfayı yenilese de aynı kalır. Web siten çalışandan bunu girmesini istemelidir.
3. adım: Sonucu bildir
Sunucundan şu sorgu parametreleriyle https://taskerdata.com/api/worker/external_qualification/data adresine bir GET isteği gönder:
| Parametre | Açıklama |
|---|---|
| qualification_id | Yeterliliğin ID'si |
| worker_token | Çalışanın sitene girdiği Token ID |
| api_token | API anahtarın |
| decision | approve veya reject |
İpucu: API anahtarın gizli kalsın diye API'yi çalışanın tarayıcısından değil, sunucundan çağır.
Kurallar ve hata mesajları
Başarılı bir çağrı, yeni durumla birlikte success true döndürür. Aksi halde success false ve şu hatalardan birini alırsın (API mesajları İngilizcedir):
- Missing required parameters: dört parametrenin tümü gereklidir.
- Decision must be approve or reject: karar approve veya reject olmalıdır.
- Invalid API token veya API token does not belong to the qualification owner: API anahtarı geçersiz veya yeterliliğin sahibine ait değil.
- Worker token not found for this qualification: bu yeterlilik için çalışan token'ı bulunamadı.
- This qualification is not configured for external submissions: yeterlilik harici gönderimler için yapılandırılmamış.
- This qualification is no longer active: duraklatılmış, tamamlanmış veya durdurulmuş testler sonuç kabul etmez.
- This worker has already been evaluated for this qualification: her çalışan yalnızca bir kez bildirilebilir.
- Worker account is suspended: çalışanın hesabı askıya alınmış.
- No remaining positions for this qualification: bu yeterlilikte kalan kontenjan yok.
Önemli: Bakiyen onaylanan bir çalışanın bonusunu karşılayamıyorsa gönderim bunun yerine beklemede olarak kaydedilir ve yanıt bir not içerir. Bakiye yükle ve panelden onayla.
Entegrasyonunu test etme
Gerçek çalışanları etkilemeden test etmek için JSON gövdeli bir POST isteğini şu adrese gönder: https://taskerdata.com/api/worker/external_qualification/data_test. Aynı dört alanı kullan, ancak api_token alanına Test API Anahtarı'nı koy.
Test uç noktası yalnızca alanların mevcut olduğunu, decision değerinin approve veya reject olduğunu ve test anahtarının geçerli olduğunu kontrol eder. Kimseyi onaylamaz veya reddetmez.
API anahtarları
Panelinin API bölümünü aç. API Anahtarı'nı oluşturmak için Yeni Anahtar Oluştur'a tıkla ve Test API Anahtarı'nı aynı sayfadan kopyala. Saatte en fazla 3 yeni anahtar oluşturabilirsin.
Yeni bir anahtar eskisinin yerini alır. Yeni bir anahtar oluşturursan sunucu kodunu güncelle, aksi halde çağrıların Invalid API token hatasıyla başarısız olur.
İpucu: Tüm teknik ayrıntılar /docs/api adresindeki API sayfasındadır.
Sık sorulan sorular
Onaylanan yeterliliğim neden duraklatılmış?
Harici yeterlilikler, önce sunucunu kurabilmen için duraklatılmış olarak başlar. Hazır olduğunda Yeterliliği sürdür'e tıkla.
Reddedilen çalışanlar kontenjan harcar mı?
Hayır. Yalnızca onaylanan ve bekleyen gönderimler kontenjanına sayılır.
Bir kararı bildirdikten sonra değiştirebilir miyim?
API çalışan başına bir sonuç kabul eder. Aynı çalışan için ikinci bir çağrı hata döndürür.