תחילת עבודה

כיצד להתחיל להשתמש ב-TCG Price Lookup API תוך 5 דקות.

1. קבל מפתח API

הירשם ב-tcgpricelookup.com וקבל מפתח API חינם מלוח הבקרה. תוכנית חינם כוללת 200 בקשות ביום וללא צורך בכרטיס אשראי.

לאחר הכניסה, עבור לסעיף Dashboard → API Keys. המפתח יראה כך:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

שמור על סודיות המפתח. אל תבצע commit לניהול גרסאות ואל תחשוף אותו בקוד צד-לקוח.

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. הצעדים הבאים