Skip to main content

GET /v1/gachas/:gacha_id

Show gacha

Overview​

Returns a specific gacha object by ID

Sample​

note

ユーザ認証についてはこちら。この API はユーザ認証認証なしでのアクセスも可能です。

curl -X GET http://localhost:3000/api/v1/gachas/dd7ca1e0-b746-4b1b-9f46-e0a6997cc672/

Response Body​

{
  "id": "74099080-e337-4d2b-b3aa-6a4c404e3bf2",
  "name": "スーパーガチャ",
  "description": "このガチャはテストようです\n良い商品が当たります。",
  "price": 500,
  "maximum": 0,
  "has_limit": false,
  "status": "selling",
  "thumbnail_image_url": "https://dev-507-assets.s3.ap-northeast-1.amazonaws.com/01G1GJYTK1YKXY6Y87JDTXXW12.jpeg",
  "lineup_image_url": "https://dev-507-assets.s3.ap-northeast-1.amazonaws.com/01G1GJYYKPFW022JSGWE20YXAN.jpeg",
  "start_at": "2022-04-25T14:45:46.000Z",
  "end_at": "2022-04-28T03:00:46.000Z",
  "is_checkin": true,
  "delivery_type": "self",
  "playable": true,
  "created_at": "2022-04-25T14:45:46.883Z",
  "updated_at": "2022-04-26T10:05:56.067Z",
  "tags": ["example"],
  "redeem_detail": {
    "probability_provision": "確率に関すること",
    "place_url": "https://devdoc.3barc.space",
    "place_text": "場所",
    "info_text": "受け取りに関して",
    "call_number": "1000番まで",
    "web_url": "https://devdoc.3barc.space"
  }
}

Gacha オブジェクト​

一覧との違いは以下となります。

  • play_count
  • redeem_detail
カラム名データ型詳細
idstringガチャの ID
namestringガチャの名前
descriptionstringガチャの詳細文
pricenumberガチャ一回分の値段(円)
maximumnumberユーザの購入回数制限
has_limitbooleanユーザの購入制限の有無
statusstringガチャの状態。購入可能なら「saling」 購入不可能の場合は「closing」 売り切れの場合は「soldout」
thumbnail_image_urlstringガチャのサムネイル
lineup_image_urlstringガチャの商品一覧画像
start_atdatetimeガチャの販売開始時間。
end_atdatetimeガチャの販売終了時間。
is_checkinbooleanガチャの発見状態。
delivery_typestringQR コードによる受け取りの場合self、郵送の場合はmail
playableboolean購入可能状態。ユーザの状態は無視されます。
play_countnumberユーザがこのガチャを購入した回数
redeem_detailRedeemDetail オブジェクト商品の引き渡しに関するオブジェクト
tagsstring[]ガチャ管理者が任意で文字列の配列を設定します