Autenticación

Cómo autenticar las solicitudes a la API TCG Price Lookup con una clave de API.

Autenticación mediante clave de API

La API TCG Price Lookup utiliza autenticación basada en claves de API. Todas las solicitudes deben incluir su clave de API.

Autenticación mediante encabezado (recomendada)

Pase su clave de API en el encabezado X-API-Key:

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

Autenticación mediante parámetro de consulta

Como alternativa, puede pasarla como parámetro de consulta:

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

Nota: La autenticación mediante encabezado es más segura. Pasar la clave como parámetro de consulta puede registrarla en los logs del servidor.

Autenticación con los SDK

Los SDK gestionan toda la autenticación automáticamente:

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

Seguridad de la clave de API

• No confirme su clave de API en el control de versiones
• Use variables de entorno (TCG_API_KEY)
• No exponga su clave de API en código del lado del cliente ni en el frontend
• Si su clave se ve comprometida, rótela de inmediato desde el panel de control

Respuestas de error

Los errores de autenticación devuelven 401 Unauthorized:

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