Obtener la lista de lotes por grupo especificado

Xsolla Developers

Obtener la lista de lotes por grupo especificadoClient-side

get/v2/project/{project_id}/items/bundle/group/{external_id}

Gets a list of bundles within a group for building a catalog.

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

In general, the use of catalog of items is available without authorization.
Only authorized users can get a personalized catalog.

SecurityXsollaLoginUserJWT

Request

path Parameters

project_id required	integer ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto. Example: 44056
external_id required	string Default: "all" ID externo del grupo.

query Parameters

limit	integer Límite para el número de elementos presentes en la página. Example: limit=50
offset	integer Número del elemento a partir del cual se genera la lista (el conteo empieza desde el 0). Example: offset=0
locale	string Default: "en" Idioma de respuesta. Código de idioma de dos letras minúsculas según la norma ISO 639-1.
additional_fields[]	Array of strings La lista de campos adicionales. Estos campos estarán en la respuesta si los envía en su solicitud. Items Enum: "media_list" "order" "long_description" "custom_attributes"
country	string Two-letter uppercase country code per ISO 3166-1 alpha-2. Check the documentation for detailed information about countries supported by Xsolla and the process of determining the country. Example: country=US
promo_code	string [ 1 .. 128 ] characters Código único que distingue entre mayúsculas y minúsculas. Contiene letras y números. Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 Muestra los artículos de duración limitada que no están disponibles para el usuario. El periodo de validez de dichos artículos no ha comenzado o ya ha expirado. Example: show_inactive_time_limited_items=1

Responses

200

La lista de lotes se recibió correctamente.

Request samples

curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/{project_id}/items/bundle/group/{external_id}?limit=50&offset=0&locale=en&additional_fields%5B%5D=media_list&country=US&promo_code=WINTER2021&show_inactive_time_limited_items=1' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

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": [ ],
"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"
}
]
}
]
}