Autentikasi

Cara mengautentikasi permintaan TCG Price Lookup API menggunakan API key.

Autentikasi API Key

TCG Price Lookup API menggunakan autentikasi berbasis API key. Setiap permintaan harus menyertakan API key Anda.

Autentikasi via Header (Disarankan)

Kirimkan API key Anda di header X-API-Key:

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

Autentikasi via Query Parameter

Sebagai alternatif, Anda bisa mengirimkannya sebagai query parameter:

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

Catatan: Autentikasi via header lebih aman. Mengirim sebagai query parameter dapat mengekspos API key di log server.

Autentikasi dengan SDK

SDK menangani semua autentikasi secara otomatis:

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

Keamanan API Key

  • Jangan commit API key ke version control
  • Gunakan variabel lingkungan (TCG_API_KEY)
  • Jangan ekspos API key di kode sisi klien atau frontend
  • Jika key bocor, rotate segera dari dashboard

Respons Error

Error autentikasi mengembalikan 401 Unauthorized:

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