Autentificare

Cum să autentificați cererile TCG Price Lookup API folosind cheia API.

Autentificare cu cheie API

TCG Price Lookup API folosește autentificare bazată pe cheie API. Toate cererile trebuie să includă cheia API.

Autentificare prin header (recomandat)

Transmiteți cheia API în headerul X-API-Key:

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

Autentificare prin parametru de interogare

Alternativ, puteți transmite cheia ca parametru de interogare:

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

Notă: Autentificarea prin header este mai sigură. Transmiterea ca parametru de interogare poate înregistra cheia API în jurnalele serverului.

Autentificare cu SDK-uri

SDK-urile gestionează automat autentificarea:

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

Securitatea cheii API

• Nu includeți cheia API în controlul versiunilor
• Folosiți variabile de mediu (TCG_API_KEY)
• Nu expuneți cheia API în cod client-side sau frontend
• Dacă cheia este compromisă, rotiți-o imediat din dashboard

Răspunsuri de eroare

Erorile de autentificare returnează 401 Unauthorized:

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