購入可能状態

ガチャを購入する前に、ユーザ側・ガチャ側のそれぞれで満たすべき条件があります。このドキュメントでは、それらの条件について整理しています。

ユーザがガチャを購入（注文を作成）するために必要な条件は主に以下の二つになります。

ガチャの販売可能状態

ガチャ詳細のplayableパラメータはガチャの購入可能状態を表します。

sellingとclosedが存在します。sellingでない場合、購入できません。

startAtとendAtはそれぞれ販売開始時間と販売終了時間を示しています。期間外の場合は、購入することができません。

warning

playableでも販売期間のバリデーションを行っていますが、サーバの処理時点での現在時刻となるためご注意ください。

ユーザはサインアップしていない場合、注文の作成を行うことができません。

サインアップAPIリファレンスはこちら

ガチャの公開ステータスが限定公開の場合は、パスコードによるガチャの発見を行うことでガチャを購入する権利を得られます。

tip

一般ユーザに公開する前に確認するユースケースなどご利用いただけます。

ガチャの設定によって、チェックインが必須のガチャが存在します。

info

チェックインが必要かどうかはガチャ詳細情報のis_required_checkinを参照してください。真の場合はチェックインを行わないとガチャを作成することができません。

チェックイン方法は以下の二つとなります。

bluetoothで発見可能なデバイス固有のIDを元にユーザが購入可能な地点にいることを証明します。

GPSの位置情報を使って、ユーザが特定の範囲内にいることを証明します。