Obter lista de pacotes por grupo especificado

Xsolla Developers

Obter lista de pacotes 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 do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto. Example: 44056
external_id required	string Default: "all" ID externo de grupo.

query Parameters

limit	integer Limite da quantidade de elementos na página. Example: limit=50
offset	integer Número do elemento a partir do qual a lista é gerada (a quantidade começa a partir de 0). Example: offset=0
locale	string Default: "en" Linguagem de resposta. Código de idioma minúsculo de duas letras de acordo com o padrão ISO 639-1.
additional_fields[]	Array of strings A lista de campos adicionais. Esses campos estarão na resposta se você enviá-los em sua solicitação. 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 exclusivo que diferencia maiúsculas de minúsculas. Contém letras e números. Example: promo_code=WINTER2021
show_inactive_time_limited_items	integer Default: 0 Exibe itens de tempo limitado que não estão disponíveis para o usuário. O prazo de validade desses itens não começou ou já expirou. Example: show_inactive_time_limited_items=1

Responses

200

A lista de conjuntos foi recebida com sucesso.

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"
}
]
}
]
}