Zewnętrzne testy kwalifikacyjne

Jak to działa

Twoja kwalifikacja na TaskerData zawiera tylko instrukcje i link. Każdy wykonawca dostaje osobisty token. Na swojej stronie prosisz o ten token, przeprowadzasz test, a potem wywołujesz nasze API z wynikiem. Wykonawca jest od razu zatwierdzany lub odrzucany.

Krok 1: Skonfiguruj kwalifikację

Koszt

Test zewnętrzny kosztuje tyle samo co zwykła kwalifikacja plus Opłata za zewnętrzne źródło w wysokości 1,00 $. Szacowany koszt w kroku Sprawdź i prześlij pokazuje pełną sumę.

Krok 2: Zatwierdzenie i konfiguracja

Po zatwierdzeniu kwalifikacji przez nasz zespół (zaufani zleceniodawcy są zatwierdzani automatycznie) startuje ona jako wstrzymana. Dostajesz wiadomość, że kwalifikacja została zatwierdzona i wymaga konfiguracji. Wykonawcy jeszcze jej nie widzą.

Otwórz kwalifikację i kliknij „Zewnętrzne źródło i API”, aby zobaczyć swój endpoint z uzupełnionym ID kwalifikacji i kluczem API. Skonfiguruj serwer, a potem kliknij „Wznów kwalifikację”, aby ją uruchomić.

Token wykonawcy

Gdy wykonawca otwiera twoją aktywną kwalifikację zewnętrzną, TaskerData pokazuje mu jego token. Token należy wyłącznie do tego wykonawcy i tej kwalifikacji i nie zmienia się po przeładowaniu strony. Twoja strona musi poprosić wykonawcę o jego wpisanie.

Krok 3: Przekaż wynik

Ze swojego serwera wyślij żądanie GET na https://taskerdata.com/api/worker/external_qualification/data z tymi parametrami zapytania:

Wskazówka: Wywołuj API ze swojego serwera, a nie z przeglądarki wykonawcy, aby klucz API pozostał prywatny.

Zasady i komunikaty o błędach

Udane wywołanie zwraca success true z nowym statusem. W przeciwnym razie otrzymasz success false i jeden z tych błędów (komunikaty API są po angielsku):

• Missing required parameters: wymagane są wszystkie cztery parametry.
• Decision must be approve or reject: decyzja musi mieć wartość approve lub reject.
• Invalid API token lub API token does not belong to the qualification owner: nieprawidłowy klucz API lub klucz nie należy do właściciela kwalifikacji.
• Worker token not found for this qualification: nie znaleziono tokenu wykonawcy dla tej kwalifikacji.
• This qualification is not configured for external submissions: kwalifikacja nie jest skonfigurowana do zgłoszeń zewnętrznych.
• This qualification is no longer active: wstrzymane, zakończone lub zatrzymane testy nie przyjmują wyników.
• This worker has already been evaluated for this qualification: każdego wykonawcę można zgłosić tylko raz.
• Worker account is suspended: konto wykonawcy jest zawieszone.
• No remaining positions for this qualification: w tej kwalifikacji nie ma już wolnych miejsc.

Ważne: Jeśli twoje saldo nie pokrywa premii dla zatwierdzonego wykonawcy, zgłoszenie zostaje zapisane jako oczekujące, a odpowiedź zawiera stosowną informację. Doładuj saldo i zatwierdź je w panelu.

Testowanie integracji

Aby testować bez wpływu na prawdziwych wykonawców, wyślij żądanie POST z treścią JSON na https://taskerdata.com/api/worker/external_qualification/data_test. Użyj tych samych czterech pól, ale w api_token wpisz swój testowy klucz API.

Testowy endpoint sprawdza tylko, czy pola są obecne, czy decision ma wartość approve lub reject i czy klucz testowy jest prawidłowy. Nikogo nie zatwierdza ani nie odrzuca.

Klucze API

Otwórz sekcję API w panelu. Kliknij „Wygeneruj nowy klucz”, aby utworzyć Klucz API, a na tej samej stronie skopiuj Testowy klucz API. Możesz wygenerować do 3 nowych kluczy na godzinę.

Nowy klucz zastępuje stary. Jeśli wygenerujesz nowy klucz, zaktualizuj kod serwera, w przeciwnym razie wywołania zakończą się błędem Invalid API token.

Wskazówka: Pełne szczegóły techniczne znajdziesz na stronie API pod adresem /docs/api.

Częste pytania