AchStats использует RESTful API, схожий с Steam Web API. Это позволяет заинтересованным разработчикам получать собранные данные. Для пользования нужен ключ доступа, который можно запросить здесь. Документация всех функций приведена ниже.
Ключи доступа являются секретными и привязаны к email. Пожалуйста, напишите ниже свой адрес email для получения 25-значного ключа. При утере его можно получить снова таким же образом.
Ключи доступа могут быть аннулированы в связи с длительной неактивностью или массовыми запросами. В таком случае Вы будете проинформированы. Вы также можете самостоятельно удалить свой ключ в любое время.
Все вызовы делаются через URL api.achievementstats.com/ и api.achstats.com/ соответственно и последующего маппинга. Адрес URL должен всегда заканчиваться 25-значным ключом доступа по форме "/?key=…".
Ответ всегда в формате JSON. Вызовы с неправильным ключом доступа выдают код состояния HTTP 403, а неизвестные вызовы - код 404.
| Частичный URL | Метод | Объяснение | Пример |
|---|---|---|---|
| profiles/<Steam64ID>/ | GET | Данные профиля с указанным Steam64ID. | profiles/76561197968240913/ |
| profiles/<Steam64ID>/games/ | GET | Купленные игры в виде AppID у профиля с указанным Steam64ID. | profiles/76561197968240913/games/ |
| profiles/<Steam64ID>/achievements/ | GET | Открытые достижения в виде имени API и их AppID у профиля с указанным Steam64ID. Используется необязательный параметр "appIds" в качестве фильтра только для определенных игр. | |
| profiles/<Steam64ID>/friends/ | GET | Друзья в виде Steam64ID у профиля с указанным Steam64ID. | profiles/76561197968240913/friends/ |
| profiles/<Steam64ID>/badges/ | GET | Открытые значки с BadgeID у профиля с указанным Steam64ID. | profiles/76561197968240913/badges/ |
| profiles/<Steam64ID>/update/ | POST | Вызывает обновление профиля с указанным Steam64ID. | profiles/76561197968240913/update/ |
| games/ | GET | Список доступных игр в виде AppID. | games/ |
| games/<AppID>/ | GET | Данные игры с указанным AppID. Также подходит для DLC, однако внешние DLC (не доступные на Steam) имеют отрицательный AppID. | |
| games/<AppID>/achievements/ | GET | Достижения игры или DLC с указанным AppID. | games/1250/achievements/ |
| games/<AppID>/badges/ | GET | Значки игры с указанным AppID. | games/1250/badges/ |
| games/<AppID>/dlcs/ | GET | DLC в виде AppID игры с указанным AppID. | games/1250/dlcs/ |
| badges/ | GET | Список доступных значков в виде BadgeID и AppID. | badges/ |
| badges/<BadgeID>/ | GET | Данные о значке с указанным BadgeID, не связанным с коллекционными карточками от игр. | badges/1/ |
| badges/<BadgeID>/stages/ | GET | Уровни значка с указанным BadgeID. | badges/1/stages/ |