Autentifikácia

Ako autentifikovať požiadavky na TCG Price Lookup API pomocou API kľúča.

Autentifikácia pomocou API kľúča

TCG Price Lookup API používa autentifikáciu založenú na API kľúčoch. Každá požiadavka musí obsahovať váš API kľúč.

Autentifikácia cez hlavičku (odporúčané)

Odošlite API kľúč v hlavičke X-API-Key:

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

Autentifikácia cez query parameter

Alternatívne ho môžete odoslať ako query parameter:

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

Poznámka: Autentifikácia cez hlavičku je bezpečnejšia. Odosielanie ako query parameter môže spôsobiť zaznamenanie API kľúča v serverových logoch.

Autentifikácia pomocou SDK

SDK automaticky spracúva všetku autentifikáciu:

// 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'])

Bezpečnosť API kľúča

• Nezahrňujte API kľúč do verzionovania kódu
• Používajte premenné prostredia (TCG_API_KEY)
• Nevystavujte API kľúč v klientskom kóde ani frontende
• V prípade úniku kľúča ho ihneď zrotujte v dashboarde

Chybové odpovede

Chyby autentifikácie vrátia 401 Unauthorized:

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