API Resources
Brief Introduction
Every Public Stash tab has a private change ID attribute.
When you update an item in a tab, or update the tab itself it's ID will take the next available one from the pool on that server shard (the old ID is discarded, and never reused).
When you query this endpoint, the ID you provide says "give me all tabs on each shard with a change ID greater than the one I provide". The backend will then fill up a packet with as many stashes as it can, and when it can't fit any more it will provide the change IDs of the tabs on each shard it was up to.
If the number of stashes returned is zero, you get back the same change ID you passed in (a hint to keep trying until the endpoint has some tabs for you).
When you update an item in a tab, or update the tab itself it's ID will take the next available one from the pool on that server shard (the old ID is discarded, and never reused).
When you query this endpoint, the ID you provide says "give me all tabs on each shard with a change ID greater than the one I provide". The backend will then fill up a packet with as many stashes as it can, and when it can't fit any more it will provide the change IDs of the tabs on each shard it was up to.
If the number of stashes returned is zero, you get back the same change ID you passed in (a hint to keep trying until the endpoint has some tabs for you).
Following Changes
GET /public-stash-tabs/?id=:id
Retrieves a list of stashes, accounts, and items as described above in the Introduction section.
Parameters
idOptional
The next change ID you received from previously fetching changes. Default: 0
Example
http://api.pathofexile.com/public-stash-tabsResponse
{
"next_change_id": "398264539-413501874-389233940-447668762-423856954",
"stashes": [
{
"accountName": "Yonnyk",
"lastCharacterName": "MOASPINSPIN",
"id": "2bb0f69bbe7090bcc0a3d5ffb33f2f66793681e269c062737b955f2ef2c7d161",
"stash": "1",
"stashType": "NormalStash",
"items": [
],
"public": false
},
{
"accountName": "Yonnyk",
"lastCharacterName": "MOASPINSPIN",
"id": "1ac136a83612e59e5a4d932bda3fcc20c21d3c44680cd2322df95667f9f13d04",
"stash": "2",
"stashType": "NormalStash",
"items": [
],
"public": false
},
{
"accountName": "Yonnyk",
"lastCharacterName": "MOASPINSPIN",
"id": "9b6ce1cf45c360692e952f45ba3abf7bdc1cb1acd657168ae74b3516f37823a5",
"stash": "3",
"stashType": "NormalStash",
"items": [
],
"public": false
},
{
"accountName": "Yonnyk",
"lastCharacterName": "MOASPINSPIN",
"id": "cc9e6b9f5ecf135e4b57e62bbd0dd95cecd361a70f273510c4f5011b0d7cd102",
"stash": "4",
"stashType": "NormalStash",
"items": [
],
"public": false
},
{
"accountName": "Yonnyk",
"lastCharacterName": "MOASPINSPIN",
"id": "0a1ec7a17d2453f9140394528fb5a4127292914cdb79d23c0eea30c9441a71df",
"stash": "5",
"stashType": "NormalStash",
"items": [
],
"public": false
}
]
}
