Xsolla-logo

Obter lista de itens virtuais

get/v2/project/{project_id}/items/virtual_items

Obtém uma lista de itens virtuais para criar um catálogo.

Atenção

Todos os projetos têm uma limitação no número de itens que você pode obter na resposta. O valor padrão e máximo é de 50 itens por resposta. Para obter mais dados página por página, use os campos limit e offset.

Observação

Em geral, o uso de catálogo de itens está disponível sem autorização.
Somente usuários autorizados podem obter um catálogo personalizado.
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
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

Código de país maiúsculo de duas letras de acordo com o padrão ISO 3166-1 alpha-2. Mostra os preços regionais e as restrições de um catálogo se eles foram especificados durante a criação de um item.

Observação

Se você não especificar o país explicitamente, ele será definido com base no endereço IP do usuário.

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 itens virtuais foi recebida com sucesso.

Request samples
Response samples
application/json
{
  • "has_more": true,
  • "items": [
    ]
}