Zum Inhalt springen

Asset-Verwaltung

Wenn du versuchst, ein Bild von der API zu erhalten, bekommst du meistens eine URL ohne eine Dateierweiterung, wie unten gezeigt.

https://assets.tcgdex.net/de/swsh/swsh3/136

Das ist normal.

Wir erlauben dir, die Erweiterung und die Qualität (für Karten) des gewünschten Bildes anzupassen.

Für cards kann die URL wie folgt rekonstruiert werden:

Terminal-Fenster
https://assets.tcgdex.net/de/swsh/swsh3/136/{quality}.{extension}

mit {quality}, das durch high oder low ersetzt wird,

und {extension}, das durch png, webp oder jpg ersetzt wird.

Details siehe unten


Einige SDKs haben Helferfunktionen, um diese leicht zu rekonstruieren.

Auf einem Card-Objekt:

// die endgültige URL abrufen
val url = card.getImageUrl("high", "webp")
// das Bild kann auch direkt abgerufen werden
val image = card.getImage("high", "webp")

Auf einem Set-Objekt:

// die endgültige URL abrufen
val symbolURL = set.getSymbolUrl("webp")
// das Symbolbild direkt abrufen
val symbol = set.getSymbol("webp")
// die endgültige URL abrufen
val logoURL = set.getLogoUrl("webp")
// das Logobild direkt abrufen
val logo = set.getLogo("webp")

Erweiterung

Alle Assets sind mit drei Erweiterungen verfügbar:

  • png: Karte mit transparentem Hintergrund
  • jpg: Karte mit schwarzem Hintergrund (nicht empfohlen)
  • webp: Modernes Format, das kompakter ist als png/jpg mit transparentem Hintergrund (empfohlen)

Qualität

Alle Assets sind in zwei Qualitäten verfügbar:

  • high: Bild im Format 600x825
  • low: Bild im Format 245x337