API%3APublic_Stashes
Old: ChuanHsing 2023-01-24 11:47:33
New: ChuanHsing 2023-01-24 11:49:12
| Old | New | Differences | |
|---|---|---|---|
| 1 | - | # | |
| 1 | + | ## Public stash API | |
| 2 | 2 | ||
| 3 | - | ||
| 3 | + | Before accessing this API, you need to apply the official OAuth form and require scope: `service:psapi`. | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | [Public stash API](https://www.pathofexile.com/developer/docs/reference#publicstashes) doesn't contain any historical data and always returns the current state of stash tabs. Using ajax from a browser got blocked by CORS, you need to setup a basic proxy to fetch it. | |
| 6 | 6 | ||
| 7 | - | One works with http cookie header, that used by official site. You can use Chrome browser in Dev Tool (Press F12), click the `Network` tab, click `Fetch/XHR` filter to see how the API used. But note that this api is not officially supported and no documentation. | |
| 7 | + | Every request will return a `next_change_id` and put it on next `id=` parameter. You will fetch the Json by sequence, for example | |
| 8 | + | ``` | |
| 9 | + | http://www.pathofexile.com/api/public-stash-tabs | |
| 10 | + | http://www.pathofexile.com/api/public-stash-tabs?id=342209785-336957592-338826328 | |
| 11 | + | http://www.pathofexile.com/api/public-stash-tabs?id=342209792-336957596-338826330 | |
| 12 | + | http://www.pathofexile.com/api/public-stash-tabs?id=342209797-336957599-338826336 | |
| 13 | + | ``` | |
| 8 | 14 | ||
| 9 | - | ||
| 15 | + | Using deflate parameter in request header will save a lot of traffic. | |
| 10 | 16 | ||
| 11 | - | ||
| 17 | + | ### Rate Limit | |
| 12 | 18 | ||
| 13 | - | * Login to pathofexile.com | |
| 14 | - | * Press F12 to open the Dev Tool | |
| 15 | - | * Click the Application tab | |
| 16 | - | * Expand the Cookies dropdown and select pathofexile.com | |
| 17 | - | * Double click the POESESSID Value and copy | |
| 19 | + | Be aware there is a [rate limit](https://www.pathofexile.com/forum/view-thread/2079853#p15244273). | |
| 18 | 20 | ||
| 19 | - |  | |
| 20 | - | ||
| 21 | - | ||
| 22 | - | ||
| 23 | - | ||
| 24 | - | ||
| 25 | - | ### Next change id | |
| 26 | - | ||
| 27 | - | You can get latest change id at https://poe.ninja/stats | |
| 28 | - | ||
| 29 | - | ||
| 30 | - | ## Data Export | |
| 31 | - | ||
| 32 | - | The game data does not have any official API, and only possible data can be analyzed from the game files. | |
| 33 | - | ||
| 34 | - | Almost all data is stored in .dat64 files within Content.ggpk. But they only have data, no headers. You can start with the .dat64 format, the [PoE dat schema](https://github.com/poe-tool-dev/dat-schema) project is the latest format. Or try to parse the .dat format from [PoE Dat Viewer](https://snosme.github.io/poe-dat-viewer/) yourself. [RePoE](https://github.com/brather1ng/RePoE/) collects many common and processed .dat files and exports them to .json format. | |
| 35 | - | ||
| 36 | - | Site | Description | |
| 37 | - | - | - | |
| 38 | - | [PyPoE](https://github.com/Project-Path-of-Exile-Wiki/PyPoE) | Collection of Python Tools for Path of Exile, mostly used by wiki | |
| 39 | - | [RePoE](https://github.com/brather1ng/RePoE/) | Repository of Path of Exile resources for tool developers. | |
| 40 | - | [Poe Dat Viewer](https://snosme.github.io/poe-dat-viewer/) | Web-base Poe Dat Viewer | |
| 41 | - | [PoE dat schema](https://github.com/poe-tool-dev/dat-schema) | Source of truth schema for dat files. | |
| 42 | - | [Path Of Building Fork schema](https://github.com/PathOfBuildingCommunity/PathOfBuilding/blob/dev/src/Export/spec.lua) | Source of Path Of Building Fork schema | |
| 43 | - | [LibGGPK2](https://github.com/aianlinb/LibGGPK2) | Windows GUI tool to view Content.ggpk and export | |
| 44 | - | ||
| 45 | - | ## Development Tool | |
| 46 | - | ||
| 47 | - | Site | Description | |
| 48 | - | - | - | |
| 49 | - | [Tooldev Discord Channel](https://discord.gg/pathofexile) | #tooldev-general | |
| 50 | - | [PoE API](https://poedb.tw/us/poe-api) | PoEDB collections of official API | |
| 51 | - | [Official Website API](https://www.pathofexile.com/developer/docs) | OAuth 2.0 API endpoints of Path of Exile | |
| 52 | - | [Skilltree Typescript](https://github.com/EmmittJ/SkillTree_TypeScript) | Best reference for how Skilltree worked | |
| 53 | - | [PoeSharp](https://github.com/andreandersen/PoeSharp) | C# Library to deal with PoE stuff | |
| 54 | - | [PoE Go](https://github.com/ccbrown/poe-go) | an entry-level guide to writing tools for PoE in the Go programming language. | |
| 55 | - | [API:Passive_Skill_Tree](API%3APassive_Skill_Tree) | |
| 56 | - | [API:OAuth](API%3AOAuth) | |
| 57 | - | [API:Ladder](API%3ALadder) | |
| 58 | - | [API:Trade](API%3ATrade) | |
| 59 | - | [API:Public_Stashes](API%3APublic_Stashes) | |
| 21 | + | ``` | |
| 22 | + | curl -XGET -s -D - http://www.pathofexile.com/api/public-stash-tabs | grep -i 'x-rate-limit' | |
| 23 | + | ``` |