統合ガイド

イベントとwebhook

試験の入り口を検証します

試験を受けようとしている回答者を検証し、このユーザーについてメタデータを追加できます.
回答者が試験を開始するように要求すると、サーバーはサーバーURLにWebhookリクエストを行い、回答者の資格情報（電子メール、パスワード、MATRIC NOなど）が有効かどうかを検証します.
サーバーは、この回答者についていくつかのメタデータでオプションの応答をすることができます。 name, email, photo, about and data.
以下の例は、検証が成功した場合にサーバーに行われたリクエストと予想される応答を模倣します

60秒以内に応答することが期待されているか、リクエストがサーバーによって終了することに注意してください.
回答者がサーバーによって検証できなかった場合、あなたは提供することが期待されています errorMessage 理由で、そうでなければあなたはそれを省略することが期待されています.オプションで提供できます metadata 検証が成功した場合.

また、回答者で顔検出を実行する予定がある場合は、 metadata.photo 回答者の鋭い画像へのリンクがあります。推奨される画像解像度は、1500x1500ピクセルを超える画像です。

チェックして、すべての着信要求をサーバーに確認してください x-client-id and x-client-secret リクエストヘッダー

{
  "event": "verify_respondent",
  "fields": [
    {
      "position": 0,
      "value": "Some valid student id"
    },
    {
      "position": 1,
      "value": "Some valid student password"
    }
  ],
  "exam_id": "some unique exam_id",
  "choosenLang": "ru"
}

以下の例は、サーバーに行われたリクエストと、検証が失敗した場合の予想される応答を模倣します

{
  "event": "verify_respondent",
  "fields": [
    {
      "position": 0,
      "value": "Some invalid student id"
    },
    {
      "position": 1,
      "value": "Some invalid student password"
    }
  ],
  "exam_id": "some unique exam_id..",
  "choosenLang": "ru"
}

有効にしてください validate fields via webhook 試験作成ページ

または、開発者APIを使用している場合は、確認してください welcomePage.validate 本当です

WebHook URLの設定

サーバーWebHook URLを設定して変更できます。

設定に移動します。
開発者セクションに移動します。
Edit and copy your webhook url

回答者のイベントを認めます

回答者が試験を受けることが認められたときに、サーバーにサーバーに通知されます。以下の例は、このシナリオを示しています

respondent_id この回答者に関する追加情報を検索します

{
  "event": "admitted_respondent",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id",
  "admittedOn": 1719221380326
}

結果対応イベント

試験の回答者の結果の準備ができたら、サーバーにサーバーに通知されます。以下の例は、このシナリオを示しています

respondent_id この回答者の結果データを検索します

{
  "event": "result_ready",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

調査完全イベント

回答者の調査が完了すると、サーバーにサーバーに通知されます。以下の例は、このシナリオを示しています

respondent_id この回答者に関する追加情報を検索します

{
  "event": "investigation_complete",
  "respondent_id": "some unique id given to the respondent",
  "exam_id": "some unique exam_id"
}

統合ガイド

イベントとwebhook

試験の入り口を検証します

WebHook URLの設定

設定に移動します。

開発者セクションに移動します。

Edit and copy your webhook url

回答者のイベントを認めます

結果対応イベント

調査完全イベント

フィードバックコメント (0)

リンクを共有します

統合ガイド