管理用ゲームを取得

Xsolla Developers

または

パブリッシャーアカウントへ

管理用ゲームを取得Server-sideAdmin

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

管理用ゲームを取得します。ゲームは、ユーザーが購入可能なゲームキーで構成されています。

注意

このエンドポイントは、ストアカタログの構築に使用しないでください。

SecuritybasicAuth

Request

path Parameters

project_id required	integer プロジェクトID。このパラメータは、ドメインページのプロジェクト名の横にあります。 Example: 44056
item_sku required	string アイテムSKU。 Example: booster_mega_1

query Parameters

promo_code

string [ 1 .. 128 ] characters

大文字と小文字を区別する一意のコードです。文字と数字が含まれます。

Example: promo_code=WINTER2021

Responses

200

ゲームは正常に受信されました。

401

基本認証が不合格または不正です。基本認証または正しい認証情報を使用したことを確認してください。

404

ゲームが見つかりません。

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/sku/{item_sku}?promo_code=WINTER2021'

Response samples

application/json

{"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": 5
},
"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": [{"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": [ ]
},
{"drm_id": 8,
"drm_image": null,
"drm_name": "Epic Games Store",
"drm_sku": "epicgames_key_1",
"is_enabled": true,
"is_free": false,
"is_sales_exist": false,
"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
},
"order": 1,
"periods": [{"date_from": null,
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"pre_order": {"description": null,
"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
}
],
"regions": [{"id": 12
},
{"id": 64
}
],
"sku": "com.xsolla.game_1_key_2",
"type": "game_key",
"virtual_prices": null
}
]
}

管理用ゲームを取得Server-sideAdmin

path Parameters

query Parameters

We respect your privacy