DokuQualifikationstests
Externe Qualifikationstests
Du kannst deinen Qualifikationstest auf deiner eigenen Website durchführen. Worker folgen deinem Link, und dein Server teilt TaskerData mit, wer bestanden hat.
So funktioniert es
Deine Qualifikation auf TaskerData enthält nur eine Anleitung und einen Link. Jeder Worker bekommt einen persönlichen Token. Auf deiner Seite fragst du nach diesem Token, führst deinen Test durch und rufst dann mit dem Ergebnis unsere API auf. Der Worker wird sofort angenommen oder abgelehnt.
Schritt 1: Qualifikation einrichten
„Fragen“ wählen
Erstelle eine neue Qualifikation und lass die Art der Qualifikation auf „Fragen“. Vorlagen können keine externe Quelle nutzen.
Einen Textbereich hinzufügen
Schreib deine Anleitung und füge den Link zu deinem Test ein. Sag Workern, dass sie ihre Token-ID auf deiner Seite eingeben sollen.
Keine Antwortfragen hinzufügen
Die externe Option erscheint nur, wenn keine Frage eine Antwort vom Typ Text, Kontrollkästchen oder Optionsfeld hat und mindestens ein Textbereich einen Link enthält.
Externe Option ankreuzen
Setze das Häkchen bei „Qualifikation über eine externe Quelle durchführen“. Der API-Link wird nach dem Einreichen bereitgestellt.
Worker wählen und einreichen
Lege Zielgruppe und Plätze wie gewohnt fest. Du kannst einen Qualifikationsbonus für Worker hinzufügen, die du annimmst.
Kosten
Ein externer Test kostet so viel wie eine normale Qualifikation plus eine Gebühr für externe Quelle von 1,00 $. Die geschätzten Kosten im Schritt „Prüfen & einreichen“ zeigen den vollen Gesamtbetrag.
Schritt 2: Freigabe und Einrichtung
Nachdem unser Team die Qualifikation freigegeben hat (vertrauenswürdige Auftraggeber werden automatisch freigegeben), startet sie pausiert. Du bekommst die Nachricht „Qualification Approved (Setup Required)“. Worker können sie noch nicht sehen.
Öffne die Qualifikation und klicke auf „Externe Quelle & API“, um deinen Endpunkt mit eingetragener Qualifikations-ID und API-Schlüssel zu sehen. Richte deinen Server ein und klicke dann auf „Qualifikation fortsetzen“, um live zu gehen.
Der Worker-Token
Wenn ein Worker deine aktive externe Qualifikation öffnet, zeigt TaskerData ihm „Deine Token-ID“. Der Token gehört nur diesem Worker und dieser Qualifikation und bleibt beim Neuladen der Seite gleich. Deine Website muss den Worker auffordern, ihn einzugeben.
Schritt 3: Das Ergebnis melden
Sende von deinem Server eine GET-Anfrage an https://taskerdata.com/api/worker/external_qualification/data mit diesen Query-Parametern:
| Parameter | Beschreibung |
|---|---|
| qualification_id | ID der Qualifikation |
| worker_token | Die Token-ID, die der Worker auf deiner Seite eingegeben hat |
| api_token | Dein API-Schlüssel |
| decision | approve oder reject |
Tipp: Rufe die API von deinem Server auf, nicht aus dem Browser des Workers, damit dein API-Schlüssel privat bleibt.
Regeln und Fehlermeldungen
Ein erfolgreicher Aufruf liefert success true mit dem neuen Status. Andernfalls erhältst du success false und einen dieser Fehler:
- „Missing required parameters“: Alle vier Parameter sind erforderlich.
- „Decision must be approve or reject“: decision muss approve oder reject sein.
- „Invalid API token“ oder „API token does not belong to the qualification owner“: ungültiger API-Schlüssel oder er gehört nicht dem Besitzer der Qualifikation.
- „Worker token not found for this qualification“: Der Worker-Token gehört nicht zu dieser Qualifikation.
- „This qualification is not configured for external submissions“: Die Qualifikation ist nicht für externe Ergebnisse eingerichtet.
- „This qualification is no longer active“: Pausierte, abgeschlossene oder gestoppte Tests nehmen keine Ergebnisse an.
- „This worker has already been evaluated for this qualification“: Jeder Worker kann nur einmal gemeldet werden.
- „Worker account is suspended“: Das Konto des Workers ist gesperrt.
- „No remaining positions for this qualification“: Es gibt keine freien Plätze mehr.
Wichtig: Reicht dein Guthaben nicht für den Bonus eines angenommenen Workers, wird die Einreichung stattdessen als ausstehend gespeichert, und die Antwort enthält einen Hinweis. Lade Guthaben auf und genehmige sie im Dashboard.
Deine Integration testen
Um zu testen, ohne echte Worker zu beeinflussen, sende eine POST-Anfrage mit JSON-Body an https://taskerdata.com/api/worker/external_qualification/data_test. Nutze dieselben vier Felder, setze aber deinen Test-API-Schlüssel in api_token.
Der Test-Endpunkt prüft nur, ob die Felder vorhanden sind, ob decision approve oder reject ist und ob der Testschlüssel gültig ist. Er nimmt niemanden an und lehnt niemanden ab.
API-Schlüssel
Öffne den API-Bereich deines Dashboards. Klicke auf „Neuen Schlüssel erzeugen“, um deinen API-Schlüssel zu erstellen, und kopiere deinen Test-API-Schlüssel von derselben Seite. Du kannst bis zu 3 neue Schlüssel pro Stunde erzeugen.
Ein neuer Schlüssel ersetzt den alten. Wenn du einen neuen erzeugst, aktualisiere deinen Server-Code, sonst schlagen deine Aufrufe mit „Invalid API token“ fehl.
Tipp: Alle technischen Details findest du auf der API-Seite unter /docs/api.
Häufige Fragen
Warum ist meine freigegebene Qualifikation pausiert?
Externe Qualifikationen starten pausiert, damit du zuerst deinen Server einrichten kannst. Klicke auf „Qualifikation fortsetzen“, wenn du bereit bist.
Verbrauchen abgelehnte Worker Plätze?
Nein. Nur genehmigte und ausstehende Einreichungen zählen zu deinen Plätzen.
Kann ich eine Entscheidung nach dem Melden ändern?
Die API nimmt ein Ergebnis pro Worker an. Ein zweiter Aufruf für denselben Worker liefert einen Fehler.