Autentizace

Jak autentizovat požadavky na TCG Price Lookup API pomocí API klíče.

Autentizace pomocí API klíče

TCG Price Lookup API používá autentizaci pomocí API klíče. Každý požadavek musí obsahovat váš API klíč.

Autentizace přes hlavičku (doporučeno)

Předejte API klíč v hlavičce X-API-Key:

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

Autentizace přes query parametr

Alternativně ho lze předat jako query parametr:

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

Poznámka: Autentizace přes hlavičku je bezpečnější. Při předání jako query parametr může být API klíč zaznamenán v serverových logu.

Autentizace přes SDK

SDK zpracovávají veškerou autentizaci automaticky:

// 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čnost API klíče

• Necommitujte API klíč do správy verzí
• Používejte proměnné prostředí (TCG_API_KEY)
• Nezveřejňujte API klíč v kódu na straně klienta ani ve frontendu
• Pokud dojde k úniku klíče, okamžitě ho rotujte z dashboardu

Chybové odpovědi

Chyby autentizace vrátí 401 Unauthorized:

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