المصادقة

كيفية مصادقة طلبات TCG Price Lookup API باستخدام مفتاح API.

مصادقة مفتاح API

يستخدم TCG Price Lookup API المصادقة القائمة على مفتاح API. يجب أن تتضمن كل طلب مفتاح API الخاص بك.

مرر مفتاح API في رأس X-API-Key:

curl https://api.tcgpricelookup.com/v1/search?q=charizard \
  -H "X-API-Key: your-api-key"

بديلاً، يمكنك تمريره كمعامل استعلام:

curl "https://api.tcgpricelookup.com/v1/search?q=charizard&api_key=your-api-key"

تنبيه: المصادقة عبر الرأس أكثر أماناً. تمرير المفتاح كمعامل استعلام قد يتسبب في تسجيله في سجلات الخادم.

تعالج SDK المصادقة تلقائياً:

// JavaScript
import { TCGLookup } from 'tcglookup';
const tcg = new TCGLookup({ apiKey: process.env.TCG_API_KEY });

# Python
from tcglookup import TCGLookup
tcg = TCGLookup(api_key=os.environ['TCG_API_KEY'])

أخطاء المصادقة تُرجع 401 Unauthorized:

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}