DocumentaciónPruebas de calificación
Pruebas de calificación externas
Puedes hacer tu prueba de calificación en tu propio sitio web. Los trabajadores siguen tu enlace y tu servidor le indica a TaskerData quién aprobó.
Cómo funciona
Tu calificación en TaskerData solo contiene instrucciones y un enlace. Cada trabajador recibe un token personal. En tu sitio, le pides ese token, haces tu prueba y luego llamas a nuestra API con el resultado. El trabajador queda aprobado o rechazado al instante.
Paso 1: Configura la calificación
Elige Preguntas
Crea una calificación nueva y deja el Tipo de calificación en Preguntas. Las plantillas no pueden usar una fuente externa.
Añade un Área de texto
Escribe tus instrucciones e incluye el enlace a tu prueba. Indica a los trabajadores que copien su ID de token en tu sitio.
No añadas preguntas con respuesta
La opción externa solo aparece cuando ninguna pregunta tiene respuesta de Texto, Casillas u Opción única y al menos un Área de texto contiene un enlace.
Marca la opción externa
Marca Realizar la calificación con una fuente externa. El enlace de la API se te da después de enviarla.
Elige trabajadores y envía
Configura la segmentación y las plazas como siempre. Puedes añadir una Bonificación por calificación para los trabajadores que apruebes.
Costo
Una prueba externa cuesta lo mismo que una calificación normal más una Tarifa de fuente externa de $1.00. El Costo estimado del paso Revisar y enviar muestra el total completo.
Paso 2: Aprobación y configuración
Cuando nuestro equipo aprueba la calificación (los solicitantes de confianza se aprueban automáticamente), empieza en pausa. Recibes un mensaje: Calificación aprobada (requiere configuración). Los trabajadores todavía no pueden verla.
Abre la calificación y haz clic en Fuente externa y API para ver tu endpoint, con el ID de tu calificación y tu clave de API ya completados. Configura tu servidor y luego haz clic en Reanudar calificación para publicarla.
El token del trabajador
Cuando un trabajador abre tu calificación externa activa, TaskerData le muestra Tu ID de token. El token pertenece solo a ese trabajador y a esa calificación, y no cambia aunque recargue la página. Tu sitio web debe pedirle al trabajador que lo introduzca.
Paso 3: Envía el resultado
Desde tu servidor, envía una solicitud GET a https://taskerdata.com/api/worker/external_qualification/data con estos parámetros de consulta:
| Parámetro | Descripción |
|---|---|
| qualification_id | ID de la calificación |
| worker_token | El ID de token que el trabajador introdujo en tu sitio |
| api_token | Tu clave de API |
| decision | approve o reject |
Consejo: Llama a la API desde tu servidor, no desde el navegador del trabajador, para que tu clave de API siga siendo privada.
Reglas y mensajes de error
Una llamada correcta devuelve success true con el nuevo estado. Si no, recibes success false y uno de estos errores:
- Missing required parameters: se necesitan los cuatro parámetros.
- Decision must be approve or reject: decision debe ser approve o reject.
- Invalid API token, o API token does not belong to the qualification owner: la clave no es válida o no pertenece al dueño de la calificación.
- Worker token not found for this qualification: el token del trabajador no existe para esta calificación.
- This qualification is not configured for external submissions: la calificación no está configurada como externa.
- This qualification is no longer active: las pruebas en pausa, completadas o detenidas no aceptan resultados.
- This worker has already been evaluated for this qualification: cada trabajador solo se puede evaluar una vez.
- Worker account is suspended: la cuenta del trabajador está suspendida.
- No remaining positions for this qualification: no quedan plazas en esta calificación.
Importante: Si tu saldo no alcanza para cubrir la bonificación de un trabajador aprobado, el envío se guarda como pendiente y la respuesta incluye una nota. Recarga tu saldo y apruébalo desde el panel.
Probar tu integración
Para hacer pruebas sin afectar a trabajadores reales, envía una solicitud POST con un cuerpo JSON a https://taskerdata.com/api/worker/external_qualification/data_test. Usa los mismos cuatro campos, pero pon tu Clave de API de prueba en api_token.
El endpoint de prueba solo comprueba que los campos estén presentes, que decision sea approve o reject y que la clave de prueba sea válida. No aprueba ni rechaza a nadie.
Claves de API
Abre la sección API de tu panel. Haz clic en Generar nueva clave para crear tu Clave de API, y copia tu Clave de API de prueba desde la misma página. Puedes generar hasta 3 claves nuevas por hora.
Una clave nueva reemplaza a la anterior. Si generas una clave nueva, actualiza el código de tu servidor o tus llamadas fallarán con Invalid API token.
Consejo: Todos los detalles técnicos están en la página de la API, en /docs/api.
Preguntas frecuentes
¿Por qué mi calificación aprobada está en pausa?
Las calificaciones externas empiezan en pausa para que puedas configurar primero tu servidor. Haz clic en Reanudar calificación cuando estés listo.
¿Los trabajadores rechazados ocupan plazas?
No. Solo los envíos aprobados y pendientes cuentan para tus plazas.
¿Puedo cambiar una decisión después de enviarla?
La API acepta un solo resultado por trabajador. Una segunda llamada para el mismo trabajador devuelve un error.