Autenticação

Como autenticar requisições à TCG Price Lookup API usando sua chave de API.

Autenticação por chave de API

A TCG Price Lookup API usa autenticação baseada em chave de API. Todas as requisições devem incluir sua chave de API.

Autenticação por cabeçalho (recomendado)

Passe sua chave de API no cabeçalho X-API-Key:

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

Autenticação por parâmetro de query

Como alternativa, você pode passar como parâmetro de query:

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

Atenção: A autenticação por cabeçalho é mais segura. Passar como parâmetro de query pode expor sua chave de API nos logs do servidor.

Autenticação com SDKs

Os SDKs gerenciam toda a autenticação automaticamente:

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

Segurança da chave de API

• Não faça commit da chave de API em sistemas de controle de versão
• Use variáveis de ambiente (TCG_API_KEY)
• Não exponha sua chave de API em código do lado do cliente ou frontend
• Se sua chave vazar, faça a rotação imediatamente pelo painel

Respostas de erro

Erros de autenticação retornam 401 Unauthorized:

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