バンドルのリストを取得

Attention

All projects have the limitation to the number of items that you can get in the response. The default and maximum value is 50 items per response.

Note

The use of the item catalog API calls is available without authorization, but to get a personalized catalog, you must pass the user JWT in the Authorization header.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id

required

integer

プロジェクトID。このパラメータは、パブリッシャーアカウントのプロジェクト名の横にあります。

Example: 44056

query Parameters

limit	integer >= 1 ページでの要素数の制限。 Example: limit=50
offset	integer >= 0 リストが生成される要素番号（カウントは0から始まります）。 Example: offset=0
locale	string Default: "en" 応答言語。ISO 639-1に基づく小文字の2文字言語コード。
additional_fields[]	Array of strings 追加フィールドのリスト。これらのフィールドは、リクエストの中で送信すると、応答に含まれます。 Items Enum: "media_list" "order" "long_description" "custom_attributes" "item_order_in_group"
country	string ISO 3166-1 alpha-2に従った2文字の大文字の国名コード。エクソーラがサポートする国と国を決定するプロセスに関する詳細情報については、ドキュメントを確認してください。 Example: country=US
promo_code	string [ 1 .. 128 ] characters 大文字と小文字を区別する一意のコードです。文字と数字が含まれます。 Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 ユーザーに利用可能でない、期限付きアイテムを表示します。このようなアイテムの有効期間はまだ開始されていないか、すでに期限切れです。 Example: show_inactive_time_limited_items=1

Responses

200

バンドルのリストは正常に受信されました。

Request samples

Response samples

application/json

{"has_more": true,
"items": [{"attributes": [{"external_id": "genre",
"name": "Genre",
"values": [{"external_id": "genre_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Casual"
},
{"external_id": "genre_eba07bfd0f982940773cba3744d97264dd58acd7",
"value": "Strategy"
},
{"external_id": "genre_b8d0c6d8f0524c2b2d79ebb93aa3cd0e8b5199a8",
"value": "Mobile"
}
]
}
],
"bundle_type": "standard",
"can_be_bought": true,
"content": [{"attributes": [{"external_id": "size",
"name": "Size",
"values": [{"external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
"value": "Large"
}
]
}
],
"description": "Big Rocket - short description.",
"groups": [ ],
"image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Big Rocket",
"price": {"amount": "10.99",
"amount_without_discount": "10.99",
"currency": "USD"
},
"quantity": 100,
"sku": "com.xsolla.big_rocket_1",
"type": "virtual_currency",
"virtual_item_type": "non_consumable",
"virtual_prices": [ ]
}
],
"custom_attributes": {"attr": "value",
"purchased": 0
},
"description": "pricePoint_44056_1",
"groups": [{"external_id": "exclusive",
"item_order_in_group": 1,
"name": "Exclusive"
}
],
"image_url": null,
"is_free": false,
"item_id": 61031,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"long_description": null,
"media_list": [ ],
"name": "kg_10.00_bundle",
"order": 999,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "9.99",
"amount_without_discount": "9.99",
"currency": "USD"
},
"promotions": [ ],
"sku": "com.xsolla.kg_1",
"total_content_price": {"amount": "10.99",
"amount_without_discount": "10.99",
"currency": "USD"
},
"type": "bundle",
"virtual_prices": [ ],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "com.xsolla.value_point_1"
},
{"amount": 50,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"is_clan": true,
"item_id": 186321,
"name": "Clan Reward VP 1",
"sku": "com.xsolla.clan_value_point_1"
}
]
}
]
}