Xsolla-logo

Obtener lista de artículos vendibles por grupo especificadoClient-side

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

Obtiene una lista de artículos vendibles del grupo especificado para crear un catálogo.

Atención

Todos los proyectos tienen la limitación del número de artículos que pueden obtenerse en la respuesta. El valor por defecto y máximo es 50 artículos por respuesta. Para obtener más datos página por página, utilice los campos limit y offset.

Observación

En general, se permite el uso del catálogo de artículos sin autorización.
Solamente los usuarios autorizados pueden obtener un catálogo personalizado.
SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer

ID del proyecto. Encontrará este parámetro en su cuenta Publisher junto al nombre del proyecto.

Example: 59080
external_id
required
string
Default: "armour"

Group external ID.

query Parameters
limit
integer

Limit for the number of elements on the page.

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

Código de país de dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2. Consulte la documentación para obtener información detallada sobre países admitidos por Xsolla y el proceso de determinación del país.

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 artículos vendibles del grupo especificado se recibió correctamente.

404

No se encontró el grupo. Asegúrese de que el external_id es correcto y de que el grupo no está desactivado ni eliminado.

Request samples
Response samples
application/json
{}