Guida alle LootBot API

Aggiornamento: 10:00 10/01/22

Una breve guida sull'utilizzo delle API di Loot Bot.

Partiamo dal fatto che dovete avere un minimo di conoscenze di programmazione base, e che si può utilizzare qualsiasi linguaggio in grado di effettuare richieste http ed elaborare dati.

Vi fornirò alcuni esempi per iniziare ad estrapolare i dati, al resto però dovete pensarci voi!

Istruzioni per una richiesta di base in php:

Per utilizzare questi esempi è necessario avere installato nel proprio server il pacchetto curl, oltre il php logicamente. Solitamente i servizi di hosting mettono a disposizione questi servizi, ma in caso non ci fossero o invece foste in possesso di una vps o dedicato, dovrete digitare questi comandi.

Su questo sito è possibile visualizzare un piccolo script che dimostra brevemente il funzionamento della funzione che visualizza i dettagli degli oggetti.

In breve, questo è uno dei tanti modi per inviare una richiesta http e ricevere in risposta i dettagli. In questo preciso caso si può navigare l'oggetto ricevuto utilizzando le frecce (->) e selezionare il dettaglio necessario. Per esempio:

Se voglio stampare il nome dell'oggetto e la rarità, posso scrivere in questo modo:

$result = $json->res->name . " (" . $json->res->rarity . ")";

Lo stesso per tutte le altre voci presenti nell'esempio che vi ho fornito sopra.

Nel caso in cui invece si volesse richiedere magari gli oggetti necessari per la creazione, sarà necessario effettuare due passaggi. Prima richiedere l'id dell'oggetto craftabile, di conseguenza gli oggetti utilizzati.

Con queste basi è possibile utilizzare tranquillamente tutte le funzioni che ho messo a disposizione.

Consulta anche lo swagger per maggiori informazioni: https://app.swaggerhub.com/apis-docs/LucaDevelop/LootBotAPI/

Le api necessitano dell'autenticazione per token, per ottenere il proprio, digitare /token sul @lootplusbot e seguire le istruzioni.

Dopo averlo ottenuto, tutti gli endpoint devono essere utilizzando specificando il token dopo la versione, esempio: /api/v2/token/funzione, quindi nel caso per esempio della ricerca per nome oggetto: /api/v2/d672gu4tv282/items/Lana.

Utilizzare in modo non consono il token comporta il ban dal gioco. Lo stesso nel caso in cui il token venga utilizzato da altre persone a propria insaputa.

Endpoint

https://fenixweb.net:6600/api/v2/{token}

Lista funzioni API

Oggetti:

/items

/items/(idoggetto)

/items/(nomeoggetto)

/items/(rarità)

Creazioni:

/crafts/(idoggetto)/needed

/crafts/(idoggetto)/used

/crafts/id

Cronologie:

/history/(market/market_direct/lotteries/auctions/payments/heists)?limit=(quantità)&offset=(distacco)&from=(nickname)&to=(nickname)&fromItem=(oggetto)&toItem=(oggetto)&both=(nickname)&fromPrice=(prezzo)&toPrice=(prezzo)&orderBy=(asc/desc)&fromDate=(yyyy-mm-dd HH:ii:ss)&toDate=(yyyy-mm-dd HH:ii:ss)

limit = quantità di risultati (numerico)

offset = distacco dal limit (numerico)

from = nickname che ha iniziato la transazione (stringa)

to = nickname destinatario per la transazione (stringa)

fromItem = oggetto del mittente (stringa)

toItem = oggetto del destinatario (stringa)

both = nickname di mittente e destinatario insieme (stringa)

fromPrice = prezzo minimo compreso (intero)

toPrice = prezzo massimo compreso (intero)

orderBy = ordinamento dei risultati (stringa)

fromDate = filtro data di inizio inclusa (data e ora)

toDate = filtro data di fine inclusa (data e ora)

Sono tutti elementi facoltativi, se il limit viene omesso sarà pari a 100.

Giocatori:

/players

/players/(nome)

Negozi:

/shop/(codice)

Team:

/team/(nome)

Ricerche:

/search/(quantità)

Figurine:

/cards

Globali:

/global

/global/ranking

/global/ranking/(nome)

Altre info:

/info