البدء السريع

كيفية البدء باستخدام TCG Price Lookup API في أقل من 5 دقائق.

1. احصل على مفتاح API

سجّل في tcgpricelookup.com واحصل على مفتاح API مجاني من لوحة التحكم. تتضمن الخطة المجانية 200 طلب يومياً بدون بطاقة ائتمان.

بعد تسجيل الدخول، انتقل إلى لوحة التحكم ← مفاتيح API. مفتاحك سيبدو هكذا:

tcg_live_sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

احتفظ بهذا المفتاح سراً. لا تضعه في نظام التحكم بالإصدارات أو تعرّضه في الكود الجانب-عميل.

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 المصادقةَ وتسلسلَ الطلبات وتحليلَ الأخطاء ورؤوسَ حد المعدل تلقائياً.

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. الخطوات التالية