Ξεκινήστε

Πώς να ξεκινήσετε με το TCG Price Lookup API σε λιγότερο από 5 λεπτά.

1. Αποκτήστε API key

Εγγραφείτε στο tcgpricelookup.com και αποκτήστε δωρεάν API key από τον πίνακα ελέγχου. Το δωρεάν πλάνο περιλαμβάνει 200 αιτήματα ανά ημέρα χωρίς πιστωτική κάρτα.

Μετά τη σύνδεση, μεταβείτε στην ενότητα Dashboard → API Keys. Το key έχει την εξής μορφή:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Κρατήστε αυτό το key μυστικό. Μην το δεσμεύσετε στον έλεγχο έκδοσης ή μην το εκθέσετε σε κώδικα client-side.

2. Εγκαταστήστε ένα SDK

Επιλέξτε τη γλώσσα που προτιμάτε και εγκαταστήστε το επίσημο SDK:

# JavaScript / TypeScript
npm install tcglookup

# Python
pip install tcglookup

# Go
go get github.com/TCG-Price-Lookup/tcglookup-go

# Rust
cargo add tcglookup

# PHP
composer require tcg-price-lookup/tcglookup

Όλα τα SDK χειρίζονται αυτόματα την αυθεντικοποίηση, τη σειριοποίηση αιτημάτων, την ανάλυση σφαλμάτων και τις κεφαλίδες rate limit.

3. Στείλτε το πρώτο αίτημα

Ακολουθούν ελάχιστα παραδείγματα για κάθε υποστηριζόμενη γλώσσα:

// JavaScript / TypeScript
import { TCGLookup } from 'tcglookup';

const tcg = new TCGLookup({ apiKey: 'your-api-key' });

const results = await tcg.search('charizard', { game: 'pokemon', limit: 5 });
console.log(results.data);
// → Πίνακας αντικειμένων καρτών με ζωντανές τιμές αγοράς
# Python
from tcglookup import TCGLookup

tcg = TCGLookup(api_key='your-api-key')
results = tcg.search('charizard', game='pokemon', limit=5)
print(results.data)
// Go
client := tcglookup.NewClient("your-api-key")
results, _ := client.Search("charizard", &tcglookup.SearchParams{Game: "pokemon"})

4. Ελέγξτε την απόκριση

Μια επιτυχημένη απόκριση έχει την εξής δομή:

{
  "data": [
    {
      "id": "pokemon-base1-4",
      "name": "Charizard",
      "game": "pokemon",
      "set": { "name": "Base Set", "code": "base1" },
      "rarity": "Rare Holo",
      "prices": {
        "nearMint": {
          "market": 450.00,
          "tcgplayer": 445.00,
          "ebay": 455.00
        },
        "lightlyPlayed": {
          "market": 380.00
        }
      }
    }
  ],
  "total": 12,
  "limit": 5,
  "offset": 0
}

5. Επόμενα βήματα