文档资格测试
外部资格测试
你可以在自己的网站上运行资格测试。工作者点击你的链接，由你的服务器告诉 TaskerData 谁通过了。
运作方式
你在 TaskerData 上的资格测试只包含说明和一个链接。每位工作者都会获得一个专属令牌。在你的网站上，你让工作者输入这个令牌，进行测试，然后把结果通过我们的 API 发送过来。工作者会立即被通过或拒绝。
第 1 步：设置资格测试
选择“问题”
新建一个资格测试，资格测试类型保持为“问题”。模板无法使用外部来源。
添加引用区域
写下你的说明，并附上测试链接。告诉工作者把他们的令牌 ID 复制到你的网站上。
不要添加需要作答的题目
只有当没有任何题目使用文本、多选框或单选作答，且至少一个引用区域包含链接时，外部选项才会出现。
勾选外部选项
勾选“使用外部来源进行资格测试”。提交后会提供 API 链接。
选择工作者并提交
像平常一样设置定向和名额。你可以为通过的工作者添加资格测试奖金。
费用
外部测试的费用与普通资格测试相同，另加 $1.00 的外部来源费用。“检查并提交”步骤中的“预估费用”会显示完整总额。
第 2 步：审核与配置
我们团队审核通过资格测试后（受信任的发布者会自动通过），它会以暂停状态开始。你会收到一条消息：“资格测试已通过（需要配置）”。此时工作者还看不到它。
打开资格测试，点击“外部来源与 API”，即可看到你的端点，其中已填好你的资格测试 ID 和 API 密钥。配置好你的服务器后，点击“恢复资格测试”即可上线。
工作者令牌
当工作者打开你进行中的外部资格测试时，TaskerData 会向他们显示“你的令牌 ID”。该令牌只属于这位工作者和这个资格测试，刷新页面也不会改变。你的网站必须让工作者输入这个令牌。
第 3 步：上报结果
从你的服务器向 https://taskerdata.com/api/worker/external_qualification/data 发送 GET 请求，并带上以下查询参数：
| 参数 | 说明 |
|---|---|
| qualification_id | 资格测试的 ID |
| worker_token | 工作者在你的网站上输入的令牌 ID |
| api_token | 你的 API 密钥 |
| decision | approve 或 reject |
提示： 请从你的服务器调用 API，而不是从工作者的浏览器调用，这样你的 API 密钥才能保密。
规则和错误信息
调用成功时会返回 success 为 true 以及新的状态。否则你会收到 success 为 false 以及以下错误之一：
- Missing required parameters：四个参数都必须提供。
- decision 必须是 approve 或 reject。
- Invalid API token，或 API token does not belong to the qualification owner（API 密钥无效，或不属于该资格测试的所有者）。
- 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（该资格测试已无剩余名额）。
重要： 如果你的余额不足以支付通过者的奖金，该提交会改为保存为待审核，响应中会附带说明。请充值后在控制台中通过它。
测试你的集成
如果想在不影响真实工作者的情况下进行测试，请向 https://taskerdata.com/api/worker/external_qualification/data_test 发送带 JSON 请求体的 POST 请求。使用同样的四个字段，但在 api_token 中填入你的测试 API 密钥。
测试端点只检查字段是否齐全、decision 是否为 approve 或 reject，以及测试密钥是否有效。它不会通过或拒绝任何人。
API 密钥
打开控制台的 API 部分。点击“生成新密钥”创建你的 API 密钥，并在同一页面复制你的测试 API 密钥。每小时最多可生成 3 个新密钥。
新密钥会替换旧密钥。如果你生成了新密钥，请更新服务器代码，否则调用会因 Invalid API token 而失败。
提示： 完整的技术细节请见 /docs/api 的 API 页面。
常见问题
为什么我已通过审核的资格测试处于暂停状态？
外部资格测试会以暂停状态开始，方便你先配置服务器。准备好后点击“恢复资格测试”即可。
被拒绝的工作者会占用名额吗？
不会。只有已通过和待审核的提交才计入你的名额。
上报结果后可以更改决定吗？
API 对每位工作者只接受一个结果。对同一位工作者再次调用会返回错误。