QueryRefundAllowed/v0001 (Steamworks ドキュメント)

Steamworks ドキュメンテーション

QueryRefundAllowed/v0001

Steamworks ドキュメント > 機能 > Steamインベントリサービス > Steamエコノミー > QueryRefundAllowed/v0001

ユーザーがゲーム内購入についてサポートサイトからより詳細な情報を得ようとした時に、Steamによって呼び出されます。応答には、購入されたアイテムの現在のステータスと、各アイテムが現在返金可能であるかどうかの情報が含まれます。

呼び出し元： Steam Refunds

HTTPメソッド： GET

パラメーター：

名前	型	必須	説明
key	string	✔	これは、パートナーサイトのアプリのSteamエコノミー設定で指定した「アセットサーバーキー」です。
appid	uint32	✔	購入に関連付けられたアプリケーションの32ビットApp ID。これはあなたのゲームのApp IDです。
steamid	uint64	✔	購入したユーザーの64ビットSteamID。
language	string	✔	返される文字列のISO 639-1言語コードとISO 3166-1アルファベット2文字の国コード。 en_US、de_DE、zh_CN、ko_KR などがその例です。既定値：en_US
orderid	uint64	✔	注文固有の64 ビットID。これはISteamMicroTxn/InitTxnの呼び出しで与えられたものと同じ注文IDです。

戻り値

このメソッドからの出力はJSONフォーマットでエンコードされている必要があります。

応答：

result
- success－メソッドが成功するとtrueを返します。アセットサーバーがfalseを返すと、その理由を説明する文字列にerrorを設定します。
- error－呼び出しが失敗した理由を説明する文字列。このメッセージは、Steamworksサイトのエコノミータブ内のエラーログに記録されます。
- assets －購入されたアイテムの配列
  - itemtypeid－アイテムのゲームID番号。これはISteamMicroTxn/InitTxnの呼び出しで与えられたitemidの値です。
  - allow_refund－購入されたアイテムが消費、変更、移転されていない場合はこれがtrueになります。
  - in_inventory－購入したユーザーが、まだアイテムを所有している場合はtrueになります。
  - bundle－ユーザーが購入したアイテムが、複数のアイテムを含むバンドルであった場合、これをtrueに設定します。バンドルの一部であるアイテムは、assets配列の次のエントリとして含めます。
  - current_state－アイテムの現在の状態の判読可能な文字列。この文字列はユーザーに表示されるため、可能な場合はローカライズします。特にallow_refundがfalseである場合は、詳細であればあるほどよいでしょう。例えば、「2015年3月25日に別のアイテムをクラフトするのに使用」または「あなたのインベントリ内」などが考えられます。
  - item_name－アイテムの名前。この文字列はユーザーに表示されるため、可能な場合はローカライズします。
  - amount－購入されたアイテムの数量。すべてのアイテムが同じidを持っている必要があります（ゲームがSteam Economy APIをサポートしていない場合は不適用）。 id の値が異なる複数のアイテムが購入されている場合は、このamountフィールドを使う代わりに、複数のエントリーをassets配列に含めます。
    
    注意：以下のフィールドは、ゲームがSteam Economy APIをサポートする場合にのみ適用されます。
  - id－ユーザーに与えられたアイテムのassetidまたはcurrencyid
  - contextid－アイテムが置かれたcontextid
  - currency－idがcurrencyidを参照している場合はtrue
  - class－ゲームが定義したアセットクラス識別子の配列。これはGetAssetClass/v0001が返すクラスと同じである必要があります。

出力例

{ "result": { "assets": [ { "itemtypeid": 594, "contextid": 2, "currency": false, "amount": 1, "id": 3837860447, "class": [ { "name": "def_index", "value": "594" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Phlogistinator" }, { "itemtypeid": 214, "contextid": 2, "currency": false, "amount": 1, "id": 3837860448, "class": [ { "name": "def_index", "value": "214" }, { "name": "flags", "value": "16" }, { "name": "origin", "value": "2", "instance": true }, { "name": "@tradable after date", "value": "1434493482", "instance": true } ] , "allow_refund": true, "in_inventory": true, "bundle": false, "current_state": "In your inventory", "item_name": "The Powerjack" } ] , "success": true } }