Ini mengembalikan semua aset dan mata uang dalam konteks tertentu untuk pengguna.
Dipanggil oleh: Antarmuka Pertukaran, Antarmuka Inventaris
Metode HTTP: GET
Parameter:
Nama | Jenis | Diperlukan | Deskripsi |
key | string | ✔ | Ini adalah "Key Server Aset" yang kamu berikan di Pengaturan Ekonomi Steam untuk aplikasimu di situs partner. |
appid | uint32 | ✔ | AppID 32-bit aplikasinya yang terkait dengan aset-aset. |
steamid | uint64 | ✔ | ID Steam 64-bit pengguna untuk mengembalikan aset. |
contextid | uint64 | ✔ | ID 64-bit konteks untuk mengembalikan aset. |
Hasil
Output dari metode ini harus dikodekan dalam format JSON.
Respons: -
result
-
success
- "True" jika metodenya berhasil. Jika server aset mengembalikan "false", error
disetel ke string yang menjelaskan alasannya.
-
error
- Sebuah string yang menjelaskan mengapa panggilannya gagal. Pesan ini akan dicatat dalam log eror, yang dapat diakses di tab menu Ekonomi di situs Steamworks.
-
assets
- Serangkaian aset yang merupakan turunan dari konteks yang ditentukan.
-
id
- ID 64-bit aset.
-
class
- Serangkaian pengidentifikasi kelas aset yang ditentukan game. Terserah pada game untuk mendefinisikan
pengidentifikasi tersebut. Pengidentifikasi perlu memberikan cukup informasi untuk menghasikan kembali info aset
(cth. menjelaskan jenis item) saat pengidentifikasi kelas diteruskan kembali ke GetAssetClassInfo/v0001. Setiap pengidentifikasi harus berisi kolom-kolom berikut:
-
name
- Nama bagian dari pengidentifikasi kelas ini.
-
value
- Nilai bagian pengidentifikasi kelas ini sebagai sebuah string.
-
instance
- Jika "true", pengidentifikasi kelas dianggap sebagai "instance data", yang berarti bahwa
pada umumnya tidak ditransfer dengan item pada pertukaran, sehingga tidak menjadi faktor nilai jual item.
(Default: false)
Catatan: Jangan pernah menganggap properti aset yang pada akhirnya berpengaruh pada market_hash_name
item di respons GetAssetClassInfo/v0001 sebagai "instance data". Pasar Komunitas bergantung pada properti instance yang tidak berpengaruh pada market_hash_name
.
Untuk memaksimalkan jumlah informasi deskripsi yang dapat di-cache oleh Steam, pengidentifikasi kelas harus bersifat umum dan dapat digunakan kembali. Sebagai contoh, hindari kelas di mana hanya terdapat satu properti dengan nama seperti "itemid" dan nilai yang merupakan ID 64-bit aset. Sebaliknya, jelaskan jenis item tersebut dengan cara yang memberikan cukup informasi untuk membangun deskripsi. Contohnya, kelas aset "type" = "sword" dan "rarity" = "common" memberikan cukup informasi untuk membuat deskripsi item tanpa harus tahu persis contoh item yang dimaksud.
-
amount
(opsional) - Jumlah tumpukan aset. Pengguna akan dapat menukarkan sebanyak jumlah ini dari tumpukan. (Default: 1)
-
currency
(opsional) - Serangkaian jenis mata uang yang terdapat dalam konteks ini. Jika pengguna tidak memiliki jenis mata uang tertentu, maka mata uang tersebut hanya boleh disertakan di sini jika akan ditampilkan di Antarmuka dalam game. Tampilan mata uang sama dengan tampilan aset, sehingga kolom-kolom untuk aset yang tercantum di atas juga diterapkan untuk mata uang, kecuali kolom class
dan id
. Selain kolom aset lainnya, dua kolom berikut digunakan untuk mata uang:
-
id
- ID 32-bit yang tidak ditandatangani yang ditetapkan untuk jenis mata uang ini. ID ini harus unik secara merata di dalam game.
-
amount
- integer 64-bit yang mewakili jumlah mata uang jenis ini yang dimiliki oleh pengguna.
Contoh Output
{
"result": {
"assets": [
{
"id": 131363189,
"class": [
{
"name": "def_index",
"value": "128"
},
{
"name": "quality",
"value": "3"
}
]
},
{
"id": 131412933,
"class": [
{
"name": "def_index",
"value": "155"
},
{
"name": "quality",
"value": "3"
}
]
},
{
"id": 556669733,
"class": [
{
"name": "def_index",
"value": "583"
},
{
"name": "flags",
"value": "1"
},
{
"name": "origin",
"value": "1",
"instance": true
}
]
},
]
,
"success": true
}
}