Das JavaScript SDK

Installation

npm i @tcgdex/sdk

bun i @tcgdex/sdk

yarn add @tcgdex/sdk

pnpm add @tcgdex/sdk

<script src="https://cdn.jsdelivr.net/npm/@tcgdex/sdk@2/dist/tcgdex.browser.js"></script>

Grundlegende Verwendung

Node/Bun
Browser

// SDK in ESM/TypeScript importieren
import TCGdex from '@tcgdex/sdk'

// ODER SDK in CommonJS importieren
const TCGdex = require('@tcgdex/sdk').default

// SDK mit Ihrer bevorzugten Sprache initialisieren
const tcgdex = new TCGdex('en');

// In einem asynchronen Kontext verwenden
(async () => {
  // Furret aus dem Darkness Ablaze Set abrufen
  const card = await tcgdex.card.get('swsh3-136');
  console.log(card.name); // "Furret"
})();

<script src="https://cdn.jsdelivr.net/npm/@tcgdex/sdk@2/dist/tcgdex.browser.js"></script>
<script>
  // SDK initialisieren
  const tcgdex = new TCGdex('en');

  // In einem asynchronen Kontext verwenden
  (async () => {
    // Furret aus dem Darkness Ablaze Set abrufen
    const card = await tcgdex.card.get('swsh3-136');
    console.log(card.name); // "Furret"
  })();
</script>

Daten abrufen

Das SDK bietet spezielle Endpunkte für gängige Datentypen:

// Eine bestimmte Karte abrufen
const card = await tcgdex.card.get('swsh3-136');

// Ein bestimmtes Set abrufen
const set = await tcgdex.set.get('swsh3');

// Eine bestimmte Serie abrufen
const serie = await tcgdex.serie.get('swsh');

// Eine Liste aller Karten abrufen
const allCards = await tcgdex.card.list();

Zufällige Daten abrufen

Sie können auch zufällige Karten, Sets oder Serien abrufen:

// Eine zufällige Karte abrufen
const randomCard = await tcgdex.random.card();

// Ein zufälliges Set abrufen
const randomSet = await tcgdex.random.set();

// Eine zufällige Serie abrufen
const randomSerie = await tcgdex.random.serie();

Erweiterte Abfragen

Das SDK bietet ein leistungsstarkes Abfragesystem zum Filtern von Daten:

import TCGdex, { Query } from '@tcgdex/sdk';

const tcgdex = new TCGdex('en');

// Eine Abfrage erstellen, um Pikachu-Karten mit HP zwischen 60 und 70 zu finden
const pikachuCards = await tcgdex.card.list(
    Query.create()
        .equal('name', 'Pikachu')  // Exakter Name
        .greaterOrEqualThan('hp', 60)  // HP >= 60
        .lesserThan('hp', 70)  // HP < 70
        .sort('localId', 'ASC')  // Nach ID aufsteigend sortieren
);

// Karten finden, die "5" in ihrer ID enthalten, aber nicht "tg"
const filteredCards = await tcgdex.card.list(
    Query.create()
        .contains('localId', '5')  // ID enthält "5"
        .not.contains('localId', 'tg')  // ID enthält nicht "tg"
);

// Paginierungsbeispiel - Seite 3 mit 2 Elementen pro Seite abrufen
const paginatedCards = await tcgdex.card.list(
    Query.create()
        .paginate(3, 2)
);

Objekt-Beziehungen

Das SDK erleichtert die Navigation zwischen verknüpften Objekten:

// Eine Karte abrufen und dann ihr Set abrufen
const card = await tcgdex.card.get('swsh3-136');
const set = await card.getSet();

// Ein Set abrufen und dann seine Serie abrufen
const set = await tcgdex.set.get('swsh3');
const serie = await set.getSerie();

// Eine Karte aus der Kartenliste eines Sets abrufen
const set = await tcgdex.set.get('swsh3');
const firstCardResume = set.cards[0];
const fullCard = await firstCardResume.getCard();

Filtern nach Attributen

Finden Sie Karten nach bestimmten Attributen:

// Alle Feuer-Typ-Karten abrufen
const fireType = await tcgdex.type.get('fire');

// Alle Karten mit bestimmten HP abrufen
const hp90Cards = await tcgdex.hp.get('90');

// Alle Karten eines bestimmten Illustrators abrufen
const illustratorCards = await tcgdex.illustrator.get('TOKIYA');

// Alle Karten mit einer bestimmten Seltenheit abrufen
const rareCards = await tcgdex.rarity.get('rare');

Konfigurationsoptionen

Das SDK bietet verschiedene Konfigurationsmöglichkeiten:

// SDK mit einer bestimmten Sprache erstellen
const tcgdex = new TCGdex('fr');  // Französisch

// Sprache nach der Initialisierung ändern
tcgdex.setLang('en');  // Zu Englisch wechseln

// Benutzerdefinierten API-Endpunkt festlegen
tcgdex.setEndpoint('https://custom-api.example.com/v2');

// Caching konfigurieren
tcgdex.setCacheTTL(3600);  // Cache-Dauer auf 1 Stunde setzen

Karten-Bilder

Einfacher Zugriff auf Kartenbilder:

const card = await tcgdex.card.get('swsh3-136');

// URL für hochqualitatives PNG-Bild abrufen
const highQualityPng = card.getImageURL('high', 'png');

// URL für WEBP-Bild mit niedriger Qualität für bessere Performance abrufen
const lowQualityWebp = card.getImageURL('low', 'webp');