Steamインベントリサービスへのアクセスに使用するインターフェイスです。
注意: これはServiceインターフェースです。このインターフェイスのメソッドは
input_json
パラメーターで呼び出す必要があります。
Steamworks Web APIの使用に関する詳細は、
Web API 概要を参照してください。
AddItem
POST https://partner.steam-api.com/IInventoryService/AddItem/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | アイテムに関連付けられたアプリケーションのID。 |
itemdefid | uint64 | ✔ | 付与するitemdefidのリスト。 これは 'itemdefid[0]'や'itemdefid[1]'のような名前の一連のパラメーターとして指定する必要があります。 |
itempropsjson | string | ✔ | |
steamid | uint64 | ✔ | アイテムを受け取るプレイヤーのSteamID。 |
notify | bool | ✔ | オプション、デフォルトは0。 1に設定すると、ユーザーがゲーム内におらずSteam通知を見る必要がある場合は表示します。 |
requestid | uint64 | ✔ | オプション、デフォルトは0。 クライアントは、最大で1回実行するリクエストに一意の識別子を提供できます。 requestidが再送信されても、再度実行されることはありません。 応答メッセージは、元の正常な実行によって影響を受けるアイテムの現在の状態になります。 |
trade_restriction | bool | ✔ | オプション、デフォルトは0。 1に設定すると、これが購入アイテムであるかのように、Steamがマーケットとトレードクールダウンを適用します |
AddItemは、ユーザーのインベントリに直接新しいアイテムを追加するために使用されます。 各itemdefについて、そのタイプのインスタンスが作成され、対象のアカウントに追加されます。
'bundle' または 'generator' のタイプのアイテムは、追加時に展開されます。 応答メッセージは、インベントリに実際に挿入されたアイテムに関する情報を提供します。
この呼び出しは、itemdefが定義されていないか展開できない場合、 または、対象プレーヤーが特定のappidに対する許可を持っていない場合に失敗します。
新しいアイテムがある場合、プレイヤーへの通知はゲームクライアントが処理することが最適です。 プレイヤーがゲーム内にいない時のAddItemへの呼び出しには、オプションで
notify=1
を設定することでSteam経由でプレイヤーに通知できます。 これには、オーバーレイでのポップアップを含むSteam内のプレイヤー通知が使用される場合があります。
オプションの
requestid
パラメーターが、クライアントがべき呼び出しを行うことを許可します。 リクエストがサーバー上で正常に完了したかがクライアントにとって不明な場合、オリジナルのリクエストIDを再利用して、再度リクエストできます。
リクエストが再度行われると、応答には、オリジナルのリクエストの影響を受けたアイテムの
現在の状態が含まれ、新たな変更は加えられません。
オリジナルのリクエストがサーバーで失敗すると、同じリクエストIDの再実行は、エラー結果を報告せずに、再試行を行います。
ユーザーが、無料ライセンスからアプリを所有している場合で、過去30日間プレイしていない場合、AddItemは失敗します。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
応答: -
response
-
success
―メソッドが成功するとtrueを返します。 アセットサーバーがfalseを返すと、その理由を説明する文字列にerror
を設定します。
-
error
- 呼び出しが失敗した理由を説明する文字列。 このメッセージは、Steamworksサイトのエコノミータブ内のエラーログに記録されます。
-
item_json
- 新しく作成されたアイテムのアイテム詳細の配列。 これは、実際のアイテムプロパティを含むエンコードされたJSONとして返されます。
-
replayed
- trueの場合、以前にrequestIDが処理されたことを意味し、応答はオリジナルの実行に基づきます。 requestidが指定されなければこれは含まれません。
応答の例:{
"response": {
"item_json":
"[{ \"accountid\":\"148618792083651397\",\"itemid\":\"17209346500926339\",\"Timestamp\":\"\",\"originalitemid\":\"17209346500926339\",\"itemdefid\":\"120\",\"appid\":480,\"position\":0,\"quantity\":1,\"transid\":\"\",\"state\":\"\",\"origin\":\"external\",\"price\":\"\",\"acquired\":\"20140912T195537Z\"}]"
}
}
呼び出しの例:curl -X POST -H "Content-Type: application/x-www-form-urlencoded" \
-d appid=480 \
-d steamid=292733980074050545 \
-d itemdefid[0]=4111 \
-d itemdefid[1]=4112 \
"http://api.steampowered.com/IInventoryService/AddItem/v1?key=xxxxxx"
AddPromoItem
POST https://partner.steam-api.com/IInventoryService/AddPromoItem/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | |
itemdefid | uint64 | | |
steamid | uint64 | ✔ | |
notify | bool | | アイテムがSteamインベントリに追加されたことをユーザーに通知します。 |
requestid | uint64 | クライアントは、最大で1回実行するリクエストに一意の識別子を提供できます。 requestidが再送信されても、再度実行されることはありません。 応答メッセージは、元の正常な実行によって影響を受けるアイテムの現在の状態になります。 | |
ユーザーのインベントリにプロモアイテムを追加します。 itemdefidパラメーター無しで呼び出された場合、指定のプレイヤーが利用できるプロモーションアイテムを確認して付与します。
注: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
ConsumeItem
POST https://partner.steam-api.com/IInventoryService/ConsumeItem/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | |
itemid | uint64 | ✔ | 消費されるアイテムのID。 |
quantity | string | ✔ | 消費される特定のアイテムスタックの数量。 |
steamid | uint64 | ✔ | |
requestid | uint64 | ✔ | クライアントは、最大で1回実行するリクエストに一意の識別子を提供できます。 requestidが再送信されても、再度実行されることはありません。 応答メッセージは、元の正常な実行によって影響を受けるアイテムの現在の状態になります。 |
アイテムの全体または一部をが消費されたとマークします。 このアクションを元に戻すことはできません。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
この呼び出しのクライアントSDKバージョンも利用可能です:
ISteamInventory::ConsumeItemExchangeItem
POST https://partner.steam-api.com/IInventoryService/ExchangeItem/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | アイテムに関連付けられたアプリケーションのID。 |
steamid | uint64 | ✔ | アイテムを所有するプレイヤーのSteamID。 |
materialsitemid | uint64 | ✔ | プレイヤーのインベントリ内にあり、対象のアイテムタイプに変換されるアイテムの一意のID。 これはmaterialsitemid[0] 、materialsitemid[1] などとして提供されます。 |
materialsquantity | uint32 | ✔ | このレシピ内での使用にマッチしたアイテムの数量。 この配列はmaterialsitemid と同じ長さでなければなりません。 |
outputitemdefid | uint64 | ✔ | 作成されるアイテムのItemDef。 |
ExchangeItemはクラフトに使用されます - 事前に定義されたレシピを使用してアイテムを変換します。 クラフトレシピえ必要とされる一連のアイテムは、変換が成功すると破壊され、プレイヤーのインベントリには対象のitemdefの新しいインスタンスが追加されます。
対象のアイテム定義は
exchange
属性で宣言された一つ以上クラフトレシピが必要です。 レシピは、対象アイテムの作成に必要なアイテムの数とタイプを宣言します。 ExchangeItems呼び出しで提供されたアイテムのセットが、どのレシピも満たさない場合 、呼び出しは失敗しインベントリは変更されません。
クラフトレシピの詳細はInventory Service
スキーマ を参照してください。
クラフト作業にはトレードとマーケット制限が考慮されます。作成されたアイテムには、作成に使用されたアイテムの最新の規制が引き継がれます。
成功した場合この呼び出しは、この呼び出しによって変更されたアイテム(消費されたアイテムと新しく作成されたアイテム)をリストするエンコードされたJSON blobを返します。
注意: Steam APIキーをゲームと一緒に配布しないでください。
このようなAPIは 必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください。
この呼び出しのクライアントSDKバージョンも利用可能です:
ISteamInventory::ExchangeItems応答: -
response
-
item_json
- 交換の影響を受けたすべてのアイテムの詳細。 実際のアイテムプロパティのエンコードされたJSONを含む文字列として返されます。 成功しなかった交換には空の配列を返します。
応答の例:{
"response": {
"item_json":
"[{ \"accountid\":\"292733980074050545\",\"itemid\":\"1503713096879725\",\"itemdefid\":\"4111\",\"state\":\"removed\" ...
}
}
呼び出しの例:curl --request POST \
--header 'content-type: multipart/form-data' \
--form appid=30400 \
--form 'materialsitemid[0]=1510699974025744' \
--form 'materialsitemid[1]=1510699974025745' \
--form 'materialsitemid[2]=1510699974025746' \
--form 'materialsquantity[0]=1' \
--form 'materialsquantity[1]=1' \
--form 'materialsquantity[2]=5' \
--form steamid=292733980074050545 \
--form outputitemdefid=4111 \
https://api.steampowered.com/IInventoryService/ExchangeItem/v1?key=xxxxxxxxxx'
GetInventory
GET https://partner.steam-api.com/IInventoryService/GetInventory/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | アイテムに関連付けられたアプリケーションのID。 |
steamid | uint64 | ✔ | インベントリをリクエストするユーザーの64ビットのSteamID。 |
GetInventoryはユーザーのインベントリの取得に使用します。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
応答: -
response
-
success
―メソッドが成功するとtrueを返します。 アセットサーバーがfalseを返すと、その理由を説明する文字列にerror
を設定します。
-
error
-呼び出しが失敗した理由を説明する文字列。 このメッセージは、Steamworksサイトのエコノミータブ内のエラーログに記録されます。
-
item_json
- インベントリのアイテム詳細の配列。 それぞれは実際のアイテムプロパティのエンコードされたJSONを含む文字列です。
出力値の詳細説明は、
コアスキーマドキュメントを参照してください。
応答の例:{
"response": {
"item_json":
"[{ \"accountid\":\"xxxxx\",\"itemid\":\"17212166272724458\",\"Timestamp\":\"2014-10-13T22:41:00.4928464Z\",\"originalitemid\":\"17212166272724458\",\"itemdefid\":\"120\",\"appid\":480,\"position\":0,\"quantity\":1,\"transid\":\"\",\"state\":\"\",\"origin\":\"external\",\"price\":\"\",\"acquired\":\"20141013T224100Z\"},
{ \"accountid\":\"xxxxx\",\"itemid\":\"17212166272732706\",\"Timestamp\":\"2014-10-13T22:42:50.1328464Z\",\"originalitemid\":\"17212166272732706\",\"itemdefid\":\"121\",\"appid\":480,\"position\":0,\"quantity\":1,\"transid\":\"\",\"state\":\"\",\"origin\":\"external\",\"price\":\"\",\"acquired\":\"20141013T224250Z\"}
]"
}}
呼び出しの例:$fields = array(
'appid' > '480',
'itemlist[0]' > '120',
'itemorigin' > '',
'steamid' > 'xxxxx',
'key' > 'xxxx'
);
var_dump($fields);
$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, $host.'/IInventoryService/GetInventory/v1?appid=480&steamid=xxxxx&key=yyyyyy' );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
$data = curl_exec( $ch );
var_dump($data);
GetItemDefs
GET https://partner.steam-api.com/IInventoryService/GetItemDefs/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | アイテムに関連付けられたアプリケーションのID。 |
modifiedsince | string | ✔ | 指定された時間以降にitemdefsに加えられた更新のみを取得するめに使用します。 形式はyyyymmddThhmmssZです。 (例 20140808T010203Z) |
itemid | uint64 | ✔ | itemdefidによって指定のitemdefのみを取得するために使用します。 |
workshopids | uint64 | ✔ | workshopidによって指定のitemdefのみを取得するために使用します。 |
cache_max_age_seconds | uint32 | | 指定された秒数の間、古いデータが返されることを許可します。 |
GetItemDefsは指定のアプリケーションのitemdefの取得に使用されます。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
応答: -
response
-
success
―メソッドが成功するとtrueを返します。 アセットサーバーがfalseを返すと、その理由を説明する文字列にerror
を設定します。
-
error
-呼び出しが失敗した理由を説明する文字列。 このメッセージは、Steamworksサイトのエコノミータブ内のエラーログに記録されます。
-
itemdef_json
- 新しく作成されたアイテムのアイテム詳細の配列。 それぞれは実際のアイテムプロパティのエンコードされたJSONを含む文字列です。
応答の例:{ "response":
{ "itemdef_json":"[
{ \"appid\":\"480\",\"itemdefid\":\"10\",\"Timestamp\":\"2014-09-12T01:29:10.4628321Z\",\"modified\":\"20140808T010203Z\",\"type\":\"generator\",\"name\":\"Drop Generator/",/"bundle/":/"100x100;101x50;102x25;103x2;110x20;111x20;120x5;121x3/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Drop Generator\",\"market_hash_name\":\"Drop Generator\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"generator\",\"itemslot\":\"generator\"},
{ \"appid\":\"480\",\"itemdefid\":\"100\",\"Timestamp\":\"2014-09-12T01:28:44.4816369Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Plus ship decoration/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Plus ship decoration\",\"market_hash_name\":\"Plus ship decoration\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"decoration\",\"itemslot\":\"decoration\"},
{ \"appid\":\"480\",\"itemdefid\":\"101\",\"Timestamp\":\"2014-09-12T01:29:25.5198429Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Star ship decoration/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Star ship decoration\",\"market_hash_name\":\"Star ship decoration\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"decoration\",\"itemslot\":\"decoration\"},
{ \"appid\":\"480\",\"itemdefid\":\"102\",\"Timestamp\":\"2014-09-12T01:29:33.6544695Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Stripe ship decoration/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Stripe ship decoration\",\"market_hash_name\":\"Stripe ship decoration\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"decoration\",\"itemslot\":\"decoration\"},
{ \"appid\":\"480\",\"itemdefid\":\"103\",\"Timestamp\":\"2014-09-12T01:29:39.5676519Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Hat ship decoration/",/"bundle/":/"/",/"price/":/"1;USD99/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Hat ship decoration\",\"market_hash_name\":\"Hat ship decoration\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"decoration\",\"itemslot\":\"decoration\"},
{ \"appid\":\"480\",\"itemdefid\":\"110\",\"Timestamp\":\"2014-09-12T01:29:44.0715525Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Doublefire gun/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Doublefire gun\",\"market_hash_name\":\"Doublefire gun\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"weapon\",\"itemslot\":\"weapon\"},
{ \"appid\":\"480\",\"itemdefid\":\"111\",\"Timestamp\":\"2014-09-12T01:29:48.9635307Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Fastfire gun/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Fastfire gun\",\"market_hash_name\":\"Fastfire gun\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"weapon\",\"itemslot\":\"weapon\"},
{ \"appid\":\"480\",\"itemdefid\":\"120\",\"Timestamp\":\"2014-09-12T01:29:52.9633305Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Cloaking field/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Cloaking field\",\"market_hash_name\":\"Cloaking field\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"power\",\"itemslot\":\"power\"},
{ \"appid\":\"480\",\"itemdefid\":\"121\",\"Timestamp\":\"2014-09-12T01:30:00.0237423Z\",\"modified\":\"20140808T010203Z\",\"type\":\"item\",\"name\":\"Shield generator/",/"bundle/":/"/",/"price/":/"/",/"quantity/":0,/"description/":/"/",/"background_color/":/"3C352E/",/"icon_url/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"icon_url_large/":/"http://cdn.beta.steampowered.com/apps/440/icons/c_fireaxe_pyro_xmas_large.fa878752e1aa09a721a03042a234063b6c929278.png/",/"market_name/":/"Shield generator\",\"market_hash_name\":\"Shield generator\",\"name_color\":\"7D6D00\",\"workshopid\":\"0\",\"flags\":1,\"game_type\":\"power\",\"itemslot\":\"power\"}
]" } }
呼び出しの例:$ch = curl_init();
curl_setopt( $ch, CURLOPT_URL, 'https://api.steampowered.com/IInventoryService/GetItemDefs/v1?appid=480&modifiedsince=&itemdefids=&workshopids=&steamid=xxxx&key=xxxxx' );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 );
$data = curl_exec( $ch );
echo $data . '<br>';
$output = json_decode( $data );
$itemdef = json_decode( $output->response->itemdef_json );
var_dump( $itemdef );
GetPriceSheet
GET https://api.steampowered.com/IInventoryService/GetPriceSheet/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIユーザー認証キーです。 |
ecurrency | int32 | ✔ | |
インベントリサービスの価格シートを取得します。
Consolidate
POST https://partner.steam-api.com/IInventoryService/Consolidate/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | |
steamid | uint64 | ✔ | |
itemdefid | uint64 配列 | ✔ | |
force | bool | | |
ユーザーのインベントリ内の指定のタイプのアイテムを統合します。
アイテムがスタックに統合される度、結果のスタックは、最も制限されたアイテムの、マーケットとトレードの制限値を引き継ぎます。 Consolidateアクションは、'force'にtrueが設定されていない限り、有効なマーケットまたはトレード規制のあるアイテムを無視します。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
GetQuantity
GET https://partner.steam-api.com/IInventoryService/GetQuantity/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | |
steamid | uint64 | ✔ | |
itemdefid | uint64[] | ✔ | 照会するitemdefidのリスト。 これは 'itemdefid[0]'や'itemdefid[1]'のような名前の一連のパラメーターとして指定する必要があります。 |
force | bool | | |
指定のタイプで利用可能なアイテムの合計数を取得します。
注意: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!
ModifyItems
POST https://partner.steam-api.com/IInventoryService/ModifyItems/v1/
名前 | 型 | 必須 | 説明 |
key | string | ✔ | Steamworks Web APIパブリッシャー認証キーです。 |
appid | uint32 | ✔ | |
input_json | string | ✔ | |
steamid | uint64 | ✔ | アイテムを所有するユーザーのsteamID。 input_json パラメーターで指定される必要があります。 |
timestamp | uint32 | ✔ | リクエストのunixタイムスタンプ。 このリクエスト以降アイテムが改変された場合には、エラーが返されます。 input_json パラメーターで指定される必要があります。 |
updates | message | ✔ | プロパティが改変されたアイテムのリスト。 input_json パラメーターで指定される必要があります。 |
updates
プロパティの構造体。
名前 | 型 | 必須 | 説明 |
itemid | uint64 | ✔ | 改変されるアイテムのID。 |
property_name | string | ✔ | 追加/更新/削除される動的プロパティの名前。 |
property_value_string | string | | 設定するプロパティの文字列値。 |
property_value_bool | bool | | 設定するプロパティのブール値。 |
property_value_int | int64 | | 設定するプロパティの64ビット整数値。 |
property_value_float | string | | 設定するプロパティの32ビットfloat値。 |
remove_property | bool | | プロパティが削除されるべき場合にはtrueを設定。 |
指定のユーザーのアイテムの
動的プロパティを改変します。 この呼び出しはユーザーごとにレート制限あり、現在1回の呼び出しで変更できるのは100アイテムのみです。
例 input_json
:
{
"steamid": "76561197970323416",
"timestamp": 1513274037,
"updates": [
{
"itemid": "1",
"property_name": "fx",
"property_value_string": "blue_flames"
},
{
"itemid": "1",
"property_name": "quality",
"property_value_string": "high"
},
{
"itemid": "1",
"property_name": "color",
"remove_property": true
}
]
}
呼び出しの例:curl --request POST \
--header 'content-type: multipart/form-data' \
--form appid=30400 \
--form 'input_json={ "steamid" : "76561197970323416", "timestamp" : 1513274037, "updates" : [] }' \
https://api.steampowered.com/IInventoryService/ModifyItems/v1?key=xxxxxxxxxx'
注: この呼び出しでは、このメソッドの使用にパブリッシャーAPIキーを必要とします。 このようなAPIは
必ずセキュリティ保護されたサーバー上から呼び出し、決して直接クライアントから使用しないでください!