予約APIからigloohomeデバイス用アクセスキー algorithm_pin を発行する時に以下のポイントをご検討ください。
-
algorithm_pin 仕様(2024-08-22時点)
- 暗証番号を指定・編集不可能、予約APIで自動発行のみ(クラウド上でアクセスパーソン作成可能)
- 9桁のランダムな暗証番号 例:968941311
- 開始・終了日時は時単位でしか設定できない(分は00)
- 有効な最大期間:365日まで
- 28日間以上有効なalgorithm_pin:開始・終了の時刻が合わせる必要がある
-
ユニバーサルアクセスキーとalgorithm_pin
- ユニバーサルアクセスキー画面には予約発行の指定した日時 "starts_at" "ends_at" が表示される。予約APIシステム上保存される期間はAPIから予約の情報を取得し、"available_starts_at" "available_ends_at"を確認してください。
- 予約API /bookingsの開始・終了日時変更またはデバイス変更した場合、algorithm_pinが更新される。ユニバーサルアクセスキー画面に最新のalgorithm_pinが自動的に片影される。
-
マージン設定とalgorithm_pin
- RLアカウントでマージン設定を含む開始・終了時刻が次時単位(分00)ではない場合、
補正利用可能開始日時(マージン込み)算出
予約APIシステム上保存される開始時刻(available_starts_at)の分単位を切捨(早くする)igloo補正利用可能開始日時(マージン込み)算出
予約APIシステム上保存される終了時刻(available_ends_at)の分単位を切上(遅くする)
- RLアカウントでマージン設定を含む開始・終了時刻が次時単位(分00)ではない場合、
例1:
設定した予約期間(マージン10分込み)→ 開始:"2024-09-25T14:10:00", 終了:"2024-09-27T11:10:00"
予約APIシステム上保存される期間→ 開始:"2024-09-25T14:00:00", 終了:"2024-09-27T11:00:00"
※時刻が00分になる
例2:利用期間 28日間以上
設定した予約期間→ 開始: "2024-09-25T08:10:00", 終了: "2024-10-25T16:02:00"
予約APIシステム上保存される期間→ 開始: "2024-09-25T08:00:00", 終了: "2024-10-26T08:00:00"
※時刻が00分になり、開始と終了の時刻を合わせるため → 終了: "2024-10-25T08:00:00"。この場合は元の利用したい時刻までカーバするため、2024-10-25 + 1day 遅くして保存される
-
RLクラウド上予約API経由で発行したalgorithm_pinについて
※同じデバイスに同じ期間の予約はクラウド上に新igloohomeゲストが発行されず、既に発行済みのalgorithm_pinを再利用する形になります。- クラウド上での見え方
-
ゲストの名前は、予約発行に指定した name
-
ゲストのemailは、予約発行に指定した email
-
ゲストの期間は、algorithm_pinが有効な期間(予約APIシステム上保存された時刻)
-
- クラウド上での見え方