イベントのタイミングの変更

デフォルトのタイミングを変更するには、最初のリクエストで pin_expiry および next_event_wait のいずれかまたは両方のカスタム値を指定します。

  • pin_expiry:

    • コードの有効期限が切れるまでの時間
    • 60~3600 秒の整数値である必要があります
    • デフォルトの有効期限はワークフローによって異なりますが、ほとんどの場合 300 秒です
  • next_event_wait:

    • Nexmo が次の検証試行をトリガーするまでの時間
    • ワークフローごとにデフォルトのタイミングが異なります

pin_expirynext_event_wait の両方に値を指定する場合、pin_expiry の値は next_event_wait の正確な倍数である必要があります。

次の表は、デフォルトのワークフロー (SMS -> TTS -> TTS) で使用した場合のいくつかの例の値と効果を示しています。

pin_expirynext_event_wait効果
360 秒120 秒3 回すべての試行で同じ確認コードを使用
240 秒120 秒1 回目と 2 回目の試行で同じコードが使用され、Verify API によって 3 回目の試行用に新しいコードが生成されます。
120 秒 (または 90 秒または 200 秒)120 秒Verify API は試行の度に新しいコードを生成します