Внешние квалификационные тесты

Как это работает

Ваша квалификация на TaskerData содержит только инструкции и ссылку. Каждый исполнитель получает личный токен. На своём сайте вы запрашиваете этот токен, проводите тест, а затем вызываете наш API с результатом. Исполнитель сразу одобряется или отклоняется.

Шаг 1: Настройте квалификацию

Стоимость

Внешний тест стоит столько же, сколько обычная квалификация, плюс плата за внешний источник $1.00. «Примерная стоимость» на шаге «Проверка и отправка» показывает полную сумму.

Шаг 2: Одобрение и настройка

После одобрения нашей командой (квалификации проверенных заказчиков одобряются автоматически) квалификация запускается в приостановленном состоянии. Вы получите сообщение «Qualification Approved (Setup Required)» — квалификация одобрена, требуется настройка. Исполнители её пока не видят.

Откройте квалификацию и нажмите «Внешний источник и API», чтобы увидеть свой эндпоинт с уже подставленными ID квалификации и API-ключом. Настройте сервер, затем нажмите «Возобновить квалификацию», чтобы запустить её.

Токен исполнителя

Когда исполнитель открывает вашу активную внешнюю квалификацию, TaskerData показывает ему «Ваш ID токена». Токен принадлежит только этому исполнителю и этой квалификации и не меняется при перезагрузке страницы. Ваш сайт должен попросить исполнителя ввести его.

Шаг 3: Передайте результат

Со своего сервера отправьте GET-запрос на https://taskerdata.com/api/worker/external_qualification/data с такими параметрами запроса:

Совет: Вызывайте API со своего сервера, а не из браузера исполнителя, чтобы ваш API-ключ оставался в секрете.

Правила и сообщения об ошибках

При успешном вызове возвращается success true и новый статус. В противном случае вы получите success false и одну из этих ошибок:

• Missing required parameters: нужны все четыре параметра.
• Decision must be 'approve' or 'reject': значение decision должно быть approve или reject.
• Invalid API token или API token does not belong to the qualification owner: ключ неверный или принадлежит не владельцу квалификации.
• Worker token not found for this qualification: токен исполнителя не найден для этой квалификации.
• This qualification is not configured for external submissions: квалификация не настроена на внешний источник.
• This qualification is no longer active: приостановленные, завершённые или остановленные тесты не принимают результаты.
• This worker has already been evaluated for this qualification: результат по каждому исполнителю можно передать только один раз.
• Worker account is suspended: аккаунт исполнителя заблокирован.
• No remaining positions for this qualification: в квалификации не осталось свободных мест.

Важно: Если на балансе не хватает средств на бонус одобренному исполнителю, работа сохраняется со статусом «на проверке», а в ответе будет примечание. Пополните баланс и одобрите её в панели.

Проверка интеграции

Чтобы проверить интеграцию, не затрагивая реальных исполнителей, отправьте POST-запрос с телом JSON на https://taskerdata.com/api/worker/external_qualification/data_test. Используйте те же четыре поля, но в api_token укажите тестовый API-ключ.

Тестовый эндпоинт проверяет только наличие полей, что decision равно approve или reject и что тестовый ключ действителен. Никого он не одобряет и не отклоняет.

API-ключи

Откройте раздел API в своей панели. Нажмите «Создать новый ключ», чтобы получить API-ключ, а тестовый API-ключ скопируйте на той же странице. Можно создавать не более 3 новых ключей в час.

Новый ключ заменяет старый. Если вы создали новый ключ, обновите код на сервере, иначе запросы будут завершаться ошибкой Invalid API token.

Совет: Все технические подробности — на странице API по адресу /docs/api.

Частые вопросы