GuidesTests de qualification
Tests de qualification externes
Vous pouvez faire passer votre test de qualification sur votre propre site. Les travailleurs suivent votre lien, et votre serveur indique à TaskerData qui a réussi.
Comment ça marche
Votre qualification sur TaskerData ne contient que des instructions et un lien. Chaque travailleur reçoit un jeton personnel. Sur votre site, vous lui demandez ce jeton, vous lui faites passer le test, puis vous appelez notre API avec le résultat. Le travailleur est approuvé ou refusé immédiatement.
Étape 1 : Configurer la qualification
Choisissez Questions
Créez une nouvelle qualification et laissez le Type de qualification sur Questions. Les modèles ne peuvent pas utiliser de source externe.
Ajoutez une Zone de texte
Rédigez vos instructions et incluez le lien vers votre test. Demandez aux travailleurs de copier leur ID de jeton sur votre site.
N'ajoutez pas de questions à réponse
L'option externe n'apparaît que si aucune question n'a de réponse de type Texte, Cases à cocher ou Choix unique, et si au moins une Zone de texte contient un lien.
Cochez l'option externe
Cochez Réaliser la qualification via une source externe. Le lien de l'API est fourni après l'envoi.
Choisissez les travailleurs et envoyez
Réglez le ciblage et les places comme d'habitude. Vous pouvez ajouter un Bonus de qualification pour les travailleurs que vous approuvez.
Coût
Un test externe coûte le même prix qu'une qualification normale, plus des Frais de source externe de $1.00. Le Coût estimé de l'étape Vérifier et envoyer affiche le total.
Étape 2 : Approbation et configuration
Une fois la qualification approuvée par notre équipe (les demandeurs de confiance sont approuvés automatiquement), elle démarre en pause. Vous recevez un message : Qualification Approved (Setup Required). Les travailleurs ne peuvent pas encore la voir.
Ouvrez la qualification et cliquez sur Source externe et API pour voir votre endpoint, avec votre ID de qualification et votre clé API déjà renseignés. Configurez votre serveur, puis cliquez sur Reprendre la qualification pour la mettre en ligne.
Le jeton du travailleur
Quand un travailleur ouvre votre qualification externe active, TaskerData lui affiche Votre ID de jeton. Ce jeton n'appartient qu'à ce travailleur et à cette qualification, et il reste le même si la page est rechargée. Votre site doit demander au travailleur de le saisir.
Étape 3 : Transmettre le résultat
Depuis votre serveur, envoyez une requête GET à https://taskerdata.com/api/worker/external_qualification/data avec ces paramètres de requête :
| Paramètre | Description |
|---|---|
| qualification_id | ID de la qualification |
| worker_token | L'ID de jeton que le travailleur a saisi sur votre site |
| api_token | Votre clé API |
| decision | approve ou reject |
Astuce : Appelez l'API depuis votre serveur, pas depuis le navigateur du travailleur, pour que votre clé API reste privée.
Règles et messages d'erreur
Un appel réussi renvoie success à true avec le nouveau statut. Sinon, vous recevez success à false et l'une de ces erreurs :
- Missing required parameters : les quatre paramètres sont obligatoires.
- Decision must be approve or reject : decision doit valoir approve ou reject.
- Invalid API token, ou API token does not belong to the qualification owner : la clé est incorrecte ou n'appartient pas au propriétaire de la qualification.
- Worker token not found for this qualification : le jeton ne correspond pas à cette qualification.
- This qualification is not configured for external submissions : la qualification n'est pas marquée comme externe.
- This qualification is no longer active : les tests en pause, terminés ou arrêtés n'acceptent pas de résultats.
- This worker has already been evaluated for this qualification : chaque travailleur ne peut être évalué qu'une fois.
- Worker account is suspended : le compte du travailleur est suspendu.
- No remaining positions for this qualification : il ne reste plus de place.
Important : Si votre solde ne suffit pas à couvrir le bonus d'un travailleur approuvé, la soumission est enregistrée en attente et la réponse contient une remarque. Rechargez votre solde et approuvez-la depuis le tableau de bord.
Tester votre intégration
Pour tester sans toucher aux vrais travailleurs, envoyez une requête POST avec un corps JSON à https://taskerdata.com/api/worker/external_qualification/data_test. Utilisez les mêmes quatre champs, mais mettez votre Clé API de test dans api_token.
L'endpoint de test vérifie seulement que les champs sont présents, que decision vaut approve ou reject, et que la clé de test est valide. Il n'approuve ni ne refuse personne.
Clés API
Ouvrez la section API de votre tableau de bord. Cliquez sur Générer une nouvelle clé pour créer votre Clé API, et copiez votre Clé API de test sur la même page. Vous pouvez générer jusqu'à 3 nouvelles clés par heure.
Une nouvelle clé remplace l'ancienne. Si vous en générez une nouvelle, mettez à jour le code de votre serveur, sinon vos appels échoueront avec Invalid API token.
Astuce : Tous les détails techniques se trouvent sur la page API, à l'adresse /docs/api.
Questions fréquentes
Pourquoi ma qualification approuvée est-elle en pause ?
Les qualifications externes démarrent en pause pour que vous puissiez d'abord configurer votre serveur. Cliquez sur Reprendre la qualification quand vous êtes prêt.
Les travailleurs refusés occupent-ils des places ?
Non. Seules les soumissions approuvées et en attente comptent dans vos places.
Puis-je modifier une décision après l'avoir transmise ?
L'API accepte un seul résultat par travailleur. Un second appel pour le même travailleur renvoie une erreur.