Mulakan

Cara mula menggunakan API TCG Price Lookup dalam masa 5 minit.

1. Dapatkan Kunci API

Daftar di tcgpricelookup.com dan dapatkan kunci API percuma dari papan pemuka. Pelan percuma termasuk 200 permintaan sehari, tiada kad kredit diperlukan.

Selepas log masuk, pergi ke bahagian Papan Pemuka → Kunci API. Kunci anda akan kelihatan seperti ini:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Rahsiakan kunci ini. Jangan komit ke kawalan versi atau dedahkan dalam kod sisi klien.

2. Pasang SDK

Pilih bahasa pilihan anda dan pasang SDK rasmi:

# 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

Semua SDK mengendalikan pengesahan, pengsirilan permintaan, penguraian ralat, dan pengepala had kadar secara automatik.

3. Hantar Permintaan Pertama

Contoh minimum dalam setiap bahasa yang disokong:

// 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);
// → Tatasusunan objek kad dengan harga pasaran langsung
# 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. Semak Respons

Respons berjaya mempunyai struktur seperti ini:

{
  "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. Langkah Seterusnya