Obtener la lista de lotes por grupo especificado

Atención

Todos los proyectos tienen la limitación de número de artículos que se pueden obtener en la respuesta. El valor por defecto y máximo es de 50 artículos por respuesta.

Nota
El uso de las llamadas API del catálogo de artículos está disponible sin autorización, pero para obtener un catálogo personalizado, debe transmitir el JWT de usuario en el encabezado Authorization.

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 >= 1 Límite para el número de elementos presentes en la página. Example: limit=50
offset	integer >= 0 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" "item_order_in_group"
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 los 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 lotes se recibió correctamente.

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