Get list of games (admin)

Xsolla Developers

Get list of games (admin)Server-sideAdmin

get/v2/project/{project_id}/admin/items/game

Obtiene la lista de juegos dentro de un proyecto para su administración. El juego se compone de claves del juego que podrían ser compradas por un usuario.

Nota

No utilice este punto final para crear un catálogo de tienda.

SecuritybasicAuth

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

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
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

Responses

200

La lista de juegos se recibió correctamente.

401

Autenticación básica no superada o errónea. Asegúrese de haber utilizado la autenticación básica o las credenciales correctas.

Request samples

curl -i -X GET \
  -u <merchant_id_or_project_id>:<api_key> \
  'https://store.xsolla.com/api/v2/project/{project_id}/admin/items/game?limit=50&offset=0&promo_code=WINTER2021'

Response samples

application/json

{"items": [{"attributes": [{"external_id": "platform",
"name": {"en-US": "Platform"
},
"values": [{"external_id": "platform_value_d847f9a494487f5e95ad218f7beecac646f15989",
"value": {"de-DE": "Windows, Linux",
"en-US": "Windows, Linux"
}
}
]
}
],
"description": {"en": "Example game 1"
},
"groups": [{"external_id": "horror",
"name": {"en": "Horror"
}
}
],
"image_url": "https://image.example.com",
"is_enabled": true,
"is_free": false,
"is_show_in_store": false,
"item_id": 1,
"long_description": {"en": "Example game's long description"
},
"media_list": [{"type": "image",
"url": "https://cdn3.xsolla.com/img/misc/images/71ab1e12126f2103e1868076f0acb21a.jpg"
}
],
"name": {"en": "Game 1"
},
"order": 1,
"sku": "com.xsolla.game_1",
"type": "unit",
"unit_items": [{"drm_id": 1,
"drm_image": "https://upload.wikimedia.org/wikipedia/en/4/48/Steam_Icon_2014.png",
"drm_name": "Steam",
"drm_sku": "steam_key_1",
"is_enabled": true,
"is_free": false,
"is_sales_exist": false,
"is_show_in_store": false,
"item_id": 3,
"keys": {"available": 3,
"total": 4,
"used": 1
},
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 10
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"order": 1,
"periods": [{"date_from": "2020-08-11T20:00:00+03:00",
"date_until": null
}
],
"pre_order": {"description": null,
"is_enabled": false,
"release_date": null
},
"prices": [{"amount": 1199.99,
"country_iso": "RU",
"currency": "RUB",
"is_default": true,
"is_enabled": true
}
],
"sku": "com.xsolla.game_1_key_1",
"type": "game_key",
"virtual_prices": [ ]
},
{"attributes": [ ],
"drm_id": 8,
"drm_image": null,
"drm_name": "Epic Games Store",
"drm_sku": "epicgames_key_1",
"groups": [ ],
"is_enabled": true,
"is_free": false,
"is_sales_exist": true,
"is_show_in_store": false,
"item_id": 4,
"keys": {"available": 0,
"total": 0,
"used": 0
},
"limits": {"per_item": null,
"per_user": null,
"recurrent_schedule": null
},
"name": {"en": "Game 1 Key 2"
},
"order": 1,
"periods": [ ],
"pre_order": {"description": "Some description",
"is_enabled": true,
"release_date": "2020-08-11T10:00:00+03:00"
},
"prices": [{"amount": 1299.99,
"country_iso": "RU",
"currency": "RUB",
"is_default": true,
"is_enabled": true
}
],
"sku": "com.xsolla.game_1_key_2",
"type": "game_key",
"virtual_prices": null
}
]
},
{"attributes": [{"external_id": "platform",
"name": {"en-US": "Platform"
},
"values": [{"external_id": "platform_value_d847f9a494487f5e95ad218f7beecac646f15989",
"value": {"de-DE": "Windows, Linux",
"en-US": "Windows, Linux"
}
}
]
}
],
"description": {"en": "Example game 2"
},
"groups": [{"external_id": "horror",
"name": {"en": "Horror"
}
}
],
"image_url": "https://image.example.com",
"is_enabled": true,
"is_free": false,
"is_show_in_store": true,
"item_id": 2,
"long_description": {"en": "Example game's long description"
},
"media_list": [ ],
"name": {"en": "Game 2"
},
"order": 1,
"sku": "com.xsolla.game_2",
"type": "unit",
"unit_items": [{"drm_id": 8,
"drm_image": null,
"drm_name": "Epic Games Store",
"drm_sku": "epicgames_key_1",
"is_enabled": false,
"is_free": false,
"is_sales_exist": true,
"is_show_in_store": false,
"item_id": 5,
"keys": {"available": 0,
"total": 0,
"used": 0
},
"limits": {"per_item": {"available": 5000,
"reserved": 500,
"sold": 4500,
"total": 10000
},
"per_user": {"total": 10
},
"recurrent_schedule": {"per_user": {"day_of_month": null,
"day_of_week": null,
"displayable_reset_next_date": "2023-02-28T11:00:00+08:00",
"displayable_reset_start_date": "2023-02-28T11:00:00+08:00",
"interval_type": "daily",
"reset_next_date": 1677553200,
"time": "11:00:00+08:00"
}
}
},
"order": 1,
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": null,
"is_enabled": false,
"release_date": null
},
"prices": [ ],
"sku": "com.xsolla.game_2_key_2",
"type": "game_key",
"virtual_prices": [{"amount": 1000,
"description": null,
"image_url": "https://i.pinimg.com/originals/91/ae/56/91ae5683045f6dbef16b1482bade938f.png",
"is_default": true,
"name": {"en": "Gold"
},
"sku": "com.xsolla.gold_1",
"type": "virtual_currency"
}
]
}
]
}
]
}