ドキュメント資格テスト
外部資格テスト
資格テストを自分のウェブサイトで実施できます。ワーカーはあなたのリンクにアクセスし、あなたのサーバーが合格者をTaskerDataに伝えます。
仕組み
TaskerData上の資格テストには、指示とリンクだけが入ります。各ワーカーには個人用のトークンが発行されます。あなたのサイトでそのトークンを入力してもらい、テストを実施してから、結果を当社のAPIに送信します。ワーカーはすぐに承認または却下されます。
ステップ1: 資格テストを設定
「質問」を選ぶ
新しい資格テストを作成し、「資格テストの種類」は「質問」のままにします。テンプレートでは外部ソースを使えません。
「引用エリア」を追加
指示を書き、テストへのリンクを入れます。ワーカーには、自分の「トークンID」をあなたのサイトにコピーするよう伝えてください。
回答する質問は追加しない
外部オプションが表示されるのは、テキスト、チェックボックス、ラジオの回答を持つ質問がなく、少なくとも1つの「引用エリア」にリンクが入っている場合だけです。
外部オプションにチェック
「外部ソースで資格テストを実施」にチェックを入れます。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: 4つのパラメータすべてが必要です。
- Decision must be approve or reject: 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: 各ワーカーの結果は1回だけ報告できます。
- Worker account is suspended: ワーカーのアカウントが停止されています。
- No remaining positions for this qualification: この資格テストに残りの募集枠がありません。
重要: 残高が承認したワーカーのボーナスに足りない場合、提出は保留として保存され、レスポンスにその旨の注記が含まれます。残高をチャージして、ダッシュボードで承認してください。
連携をテストする
実際のワーカーに影響を与えずにテストするには、同じ4つの項目を使い、api_token に「テスト用APIキー」を入れて、JSON本文付きのPOSTリクエストを次のURLに送信します: https://taskerdata.com/api/worker/external_qualification/data_test.
テスト用エンドポイントは、項目がそろっているか、decision が approve または reject か、テスト用キーが有効かだけを確認します。誰も承認・却下されません。
APIキー
ダッシュボードの「API」セクションを開きます。「新しいキーを生成」をクリックして「APIキー」を作成し、同じページから「テスト用APIキー」をコピーします。新しいキーは1時間に3つまで生成できます。
新しいキーは古いキーに置き換わります。新しいキーを生成した場合はサーバーのコードを更新してください。更新しないと、呼び出しが Invalid API token で失敗します。
ヒント: 技術的な詳細は、/docs/api のAPIページをご覧ください。
よくある質問
承認された資格テストが一時停止になっているのはなぜですか?
外部資格テストは、先にサーバーを設定できるよう一時停止の状態で始まります。準備ができたら「資格テストを再開」をクリックしてください。
却下されたワーカーで募集枠が減りますか?
いいえ。募集枠に数えられるのは、承認済みと保留中の提出だけです。
報告した判断を後から変更できますか?
APIが受け付けるのはワーカー1人につき1つの結果です。同じワーカーで2回目の呼び出しをするとエラーが返されます。