AchStats utilizza un'API RESTful simile a quella web di Steam. I dati raccolti vengono resi disponibili agli sviluppatori interessati tramite questo processo. Per utilizzare l'API avrai bisogno di una chiave d'accesso, che puoi richiedere da questa pagina; più sotto troverai anche la documentazione di tutte le funzionalità.
Le chiavi d'accesso sono segrete e legate agli indirizzi email da cui vengono richieste. Inserisci il tuo indirizzo email per ricevere la tua chiave di 25 cifre. In caso di smarrimento, potrai richiederla nuovamente usando lo stesso processo.
Le chiavi d'accesso potrebbero essere revocate in caso di inattività prolungata o di un numero elevato di richieste. Provvederemo a informarti della cosa se ciò dovesse accadere. Volendo, potrai anche eliminarla manualmente.
Tutte le richieste sono inviate rispettivamente tramite gli URL api.achievementstats.com/ e api.achstats.com/, da modificare come di seguito: l'URL deve sempre terminare con la chiave d'accesso di 25 cifre, da aggiungere in fondo a "/?key=…".
Il risultato sarà sempre in formato JSON. Le richieste inviate usando una chiave d'accesso non valida forniranno un codice di stato HTTP 403; le richieste sconosciute forniranno un codice di stato HTTP 404.
| Parte dell'URL | method | Spiegazione | Esempio |
|---|---|---|---|
| profiles/<Steam64ID>/ | get | I dati del profilo indicato dall'ID di Steam a 64 bit (Steam64ID). | profiles/76561197968240913/ |
| profiles/<Steam64ID>/games/ | get | Giochi posseduti dal profilo indicato dall'ID di Steam a 64 bit (Steam64ID), mostrati con la loro ID specifica (AppID). | profiles/76561197968240913/games/ |
| profiles/<Steam64ID>/achievements/ | get | Gli achievement sbloccati dal profilo indicato dall'ID di Steam a 64 bit (Steam64ID) mostrati con il loro nome nell'API. Usa il parametro facoltativo "appIds" per mostrare solo i giochi specificati. | |
| profiles/<Steam64ID>/friends/ | get | Gli amici del profilo indicato, mostrati come ID di Steam a 64 bit (Steam64ID). | profiles/76561197968240913/friends/ |
| profiles/<Steam64ID>/badges/ | get | Le medaglie sbloccate dal profilo indicato dall'ID di Steam a 64 bit (Steam64ID), mostrate con la loro ID specifica (BadgeID). | profiles/76561197968240913/badges/ |
| profiles/<Steam64ID>/update/ | post | api_docs_profiles_update | profiles/76561197968240913/update/ |
| games/ | get | L'elenco dei giochi disponibili, mostrati con la loro ID specifica (AppID). | games/ |
| games/<AppID>/ | get | I dati del gioco indicato dall'ID inserita (AppID). Valida anche per i DLC, anche se quelli esterni (ovvero non disponibili su Steam) hanno un'AppID negativa. | |
| games/<AppID>/achievements/ | get | Gli achievement del gioco o DLC indicato dall'ID inserita (AppID). | games/1250/achievements/ |
| games/<AppID>/badges/ | get | Le medaglie del gioco indicato dall'ID inserita (AppID). | games/1250/badges/ |
| games/<AppID>/dlcs/ | get | I DLC del gioco indicato, mostrati con le rispettive ID (AppID). | games/1250/dlcs/ |
| badges/ | get | L'elenco delle medaglie disponibili, mostrate con la rispettiva ID (BadgeID) e l'ID del gioco di provenienza (AppID). | badges/ |
| badges/<BadgeID>/ | get | I dati della medaglia indicata dall'ID inserita (BadgeID), non correlati alle carte collezionabili dei giochi. | badges/1/ |
| badges/<BadgeID>/stages/ | get | Gli stadi della medaglia indicata dall'ID inserita (BadgeID). | badges/1/stages/ |