アクショントリガー:post-change-password - APIのオブジェクト
post-change-password
アクショントリガーのAPIオブジェクトには以下が含まれます。
api.cache
実行間で維持されるデータの保管と取得を行います。
api.cache.delete(key)
提供されたkeyにキャッシュ済みの値が存在する場合は、それを記述したレコードを削除します。
値がキャッシュから削除されると、CacheWriteResult
オブジェクトにtype: "success"
を含めて返します。操作に失敗すると、type: "error"
を返します。エラーの場合には、返すオブジェクトにcode
プロパティを含めて、失敗の詳細を示します。
パラメーター | 説明 |
---|---|
key |
文字列。キャッシュに保管されているレコードのキー。 |
api.cache.get(key)
存在する場合、提供されたkey
にキャッシュ済みの値が存在する場合は、それを記述したレコードを取得します。レコードが見つかった場合には、返されたオブジェクトのvalue
プロパティにキャッシュ済みの値があります。
提供されたkey
にキャッシュ済みの項目が存在する場合は、それを記述したレコードを返します。キャッシュレコードは、キャッシュされた値のあるvalue
プロパティと、レコードの最大有効期限をUNIXエポックからのミリ秒単位で示すexpires_at
プロパティを含むオブジェクトです。
重要: このキャッシュは、短命で一時的なデータ向けに設計されています。項目が所定のライフタイム内であったとしても、後のトランザクションでは利用できないかもしれません。
パラメーター | 説明 |
---|---|
key |
文字列。キャッシュに保管されているレコードのキー。 |
api.cache.set(key, value, [options])
指定されたkeyのキャッシュに文字列値を保管または更新します。
このキャッシュに保管された値は、それを設定するトリガーにスコープが限定されます。これはアクションのキャッシュ制限の対象になります。
このように保管された値には、指定されたttl
またはexpires_at
値までのライフタイムがあります。ライフタイムが指定されない場合には、デフォルトのライフタイムである15分が使用されます。ライフタイムはアクションのキャッシュ制限が定める最大値を超過してはいけません。
パラメーター | 説明 |
---|---|
key |
文字列。キャッシュに保管されているレコードのキー。 |
value |
文字列。保管するレコードの値。 |
options |
任意のオブジェクト。キャッシュの動作を調整するためのオプション。 |
options.expires_at |
任意の数値。UNIXエポックからのミリ秒単位で指定した絶対有効期限です。キャッシュ済みのレコードは早期に削除されることはあっても、
注意:この値が |
options.ttl |
任意の数字。このキャッシュエントリーのミリ秒単位で指定した存続時間。キャッシュ済みのレコードは早期に削除されることはあっても、
注意:この値が |