EN
In my last post I showed how to transfer HSBI and Splinterland cards to other users. I only explained how it works and showed a small example where you had to enter the ID of the card yourself. This can be found easily at peakmonsters.com.
In this post I show how to check if username exists at Splinterlands and how to get your cards and their IDs. This has nothing to do with Hivejs, just the transfer at the end. But maybe someone is interested and then you don't have to search for it like me.
Splinterlands API
There is an API from Splinterlands, its URL is https://api.splinterlands.io/ and you can find the documentation here https://github.com/kiokizz/Splinterlands-API.
Check users
With the URL https://api.splinterlands.io/players/details?name= you can get details about a user, just add the username at the end.
You can test this in the browser, here are two examples, one an existing user and one a non-existing user:
https://api.splinterlands.io/players/details?name=mein-senf-dazu
https://api.splinterlands.io/players/details?name=hive-coding
As you can see, the output for a non-existing user is the error "Player @hive-coding not found." and for an existing user the data about the user. The data output is a JSON.
In the browser we see the directly readable data, but we can also display the raw data.
Retrieve your cards
Using the URL https://api.splinterlands.io/cards/collection/ you can retrieve a player's card collection, just append the player name, e.g. https://api.splinterlands.io/cards/collection/mein-senf-dazu.
You will get all the cards with some details about the cards, including the ID
For the transfer the ID is important and that "market_id" and "delegated_to" are "null". If there is an ID or a player name in it, like in the picture above, this card is currently not released for transfer, because it is for sale, rented or delegated.
The Script
Here a short explanation to my example script:
At the end of the script in line 132 the function loadCardDetail() is called.
This will retrieve the data for each card, including which edition the cards belong to, the name of the card, type.
To be able to display an image, we need the edition and the name, among other things. Once the data is loaded, it is stored in cardDetails and the LoadCards function is called (lines 47 and 48).
The function loadCards loads all my cards (from my main account @mein-senf-dazu) and displays them in a table.
It asks in line 67 that the card is neither rented, delegated nor for sale and that the card has only 1 XP.
Here, of course, you can still use one or the other to filter. I chose 1 XP to avoid accidentally sending good cards.
In line 75-80 a new line and thus card is added to the table. Thereby a checkbox, which has the value of the card UID, the image, the name and the card UID is output.
The URL for the image I have to assemble a bit in the process, unfortunately this is not stored in the details and I had to test a bit to figure out the exact structure.
In line 93-102 the button is assigned what should happen after clicking. The selected cards are read in and passed to the sendCardtouser function together with the entered username.
The function sendCardtouser first checks if the user is a player at Splinterlands and only if this is the case, the cards will be transferred. How the structure of the call must be, I have described in my last post.
Is also actually quite simple or? As long as you know it once and know what to look out for.
The whole thing is of course nicer implemented on https://peakmonsters.com/ and can be used there very easily. But maybe you have special wishes that are not possible there and can implement it now.
Do you use the site and do you miss a function, then let me know. I had seen here and there that someone had written an extension for Peakmonsters.
You can find the example here, use this only locally, never enter your private active key on jsfiddle!
If you have any questions, feel free to leave a comment. It's best to mention @mein-senf-dazu, so I'll get it.
Translated with www.DeepL.com/Translator (free version)
DE
In meinem letzten Beitrag habe ich gezeigt, wie man HSBI und Splinterlandskarten an andere Nutzer transferiert. Dabei habe ich nur die Funktionsweise erklärt und ein kleines Beispiel gezeigt erstellt, bei dem man selber die ID der Karte eingeben musste. Diese kann man ganz einfach bei peakmonsters.com finden.
In diesem Beitrag zeige ich, wie man prüft, ob der Username vergeben ist bei Splinterlands und wie man an seine Karten und deren IDs kommt. Dies hat nichts mit Hivejs zu tun, nur der Transfer am Ende. Aber vielleicht interessiert es doch jemanden und dann muss man nicht wie ich danach suchen.
Splinterlands API
Es gibt eine API von Splinterlands, deren URL ist https://api.splinterlands.io/ und die Dokumentation findet ihr hier https://github.com/kiokizz/Splinterlands-API.
Nutzer prüfen
Über die URL https://api.splinterlands.io/players/details?name= kann man Details zu einem User abrufen, dafür einfach den Nutzernamen am Ende anfügen.
Ihr könnt das einmal im Browser testen, hier zwei Beispiele, ein existierender Nutzer und einmal ein nicht existierender Nutzer:
https://api.splinterlands.io/players/details?name=mein-senf-dazu
https://api.splinterlands.io/players/details?name=hive-coding
Wie ihr sehen könnt, wird bei einem nicht existierenden Nutzer der Fehler "Player @hive-coding not found." ausgegeben und bei einem existierenden Nutzer die Daten zu dem Nutzer. Die Daten werden als JSON ausgegeben.
Im Browser sehen wir die direkt leserlich, können uns aber auch die Rohdaten anzeigen lassen.
Deine Karten abrufen
Über die URL https://api.splinterlands.io/cards/collection/ kann man die Karten eines Spielers abrufen, dazu muss man nur dessen Spielername anhängen, z.B. https://api.splinterlands.io/cards/collection/mein-senf-dazu.
Ihr erhaltet alle Karten mit einigen Details zu den Karten, u.a. die ID
Für den Transfer ist die ID wichtig und dass "market_id" sowie "delegated_to" "null" sind. Sofern, wie beim oberen Bild, eine ID drin steht oder ein Spielername, ist diese Karte aktuell nicht für den Transfer freigegeben, da diese zum Verkauf steht, vermietet oder delegiert ist.
Das Script
Hier eine kurze Erklärung zu meinen Beispielscript:
Am Ende des Scriptes in Zeile 132 wird die Funktion loadCardDetail() aufgerufen.
Dadurch werden die Daten zu den einzelnen Karten abgerufen, u.a. zu welcher Edition die Karten gehören, der Name der Karte, Art.
Um ein Bild anzeigen zu können, benötigen wir u.a. die Edition und den Namen. Sobald die Daten geladen sind, werden diese in cardDetails gespeichert und die Funktion LoadCards aufgerufen (Zeile 47 und 48).
Die Funktion loadCards lädt alle meine Karten (von meinem Hauptaccount @mein-senf-dazu) und zeigt diese in einer Tabelle an.
Dabei wird in Zeile 67 abgefragt, dass die Karte weder vermietet, delegiert noch zum Verkauf steht und dass die Karte nur 1 XP hat.
Hier kann man natürlich noch das eine oder andere nutzen zum Filtern. Ich habe 1 XP gewählt, um nicht versehentlich gute Karten zu verschicken.
In Zeile 75-80 wird eine neue Zeile und somit Karte der Tabelle hinzugefügt. Dabei wird eine Checkbox, die den Wert der Karte-UID hat, das Bild, der Name und die Karten-UID ausgegeben.
Die URL für das Bild muss ich dabei etwas zusammenbauen, leider ist diese nicht in den Details gespeichert und ich musste etwas testen, um den genauen Aufbau herauszufinden.
In Zeile 93-102 wird dem Button zugewiesen, was passieren soll nach dem Klicken. Die ausgewählten Karten werden eingelesen und zusammen mit dem eingegebenen Nutzernamen an die Funktion sendCardtouser übergeben.
Die Funktion sendCardtouser prüft erst einmal, ob der Nutzer ein Spieler bei Splinterlands ist und nur sofern das der Fall ist, werden die Karten transferiert. Wie der Aufbau des Aufrufs sein muss, habe ich in meinem letzten Beitrag beschrieben.
Ist doch auch eigentlich ganz einfach oder? Sofern man es einmal weiß und weiß, worauf man achten muss.
Das Ganze ist auf https://peakmonsters.com/ natürlich schöner umgesetzt und kann da sehr einfach genutzt werden. Aber vielleicht habt ihr ja doch speziell Wünsche, die dort nicht möglich sind und könnt es nun damit umsetzen.
Nutzt ihr die Seite und vermisst ihr da eine Funktion, dann lasst es mich doch wissen. Ich hatte hier und da schon mal gesehen, dass jemand für Peakmonsters eine Erweiterung geschrieben hatte.
Das Beispiel findet ihr hier, nutzt diesen nur Lokal, gebt nie euren privaten Aktiv-Schlüssel auf jsfiddle ein!
Wer Fragen hat, kann gern ein Kommentar da lassen. Am besten @mein-senf-dazu erwähnen, damit ich es mitbekomme.