Αυθεντικοποίηση

Πώς να αυθεντικοποιείτε αιτήματα στο TCG Price Lookup API με API key.

Αυθεντικοποίηση με API key

Το TCG Price Lookup API χρησιμοποιεί αυθεντικοποίηση βάσει API key. Κάθε αίτημα πρέπει να περιλαμβάνει το API key σας.

Αυθεντικοποίηση μέσω κεφαλίδας (Προτεινόμενη)

Περάστε το API key σας στην κεφαλίδα X-API-Key:

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

Αυθεντικοποίηση μέσω query parameter

Εναλλακτικά, μπορείτε να το περάσετε ως query parameter:

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

Σημείωση: Η αυθεντικοποίηση μέσω κεφαλίδας είναι ασφαλέστερη. Το πέρασμα ως query parameter μπορεί να εκθέσει το API key σε logs εξυπηρετητή.

Αυθεντικοποίηση με SDK

Τα SDK χειρίζονται αυτόματα όλη την αυθεντικοποίηση:

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

Ασφάλεια API key

• Μην δεσμεύετε το API key στον έλεγχο έκδοσης
• Χρησιμοποιήστε μεταβλητές περιβάλλοντος (TCG_API_KEY)
• Μην εκθέτετε το API key σε κώδικα client-side ή frontend
• Αν διαρρεύσει το key σας, περιστρέψτε το αμέσως από τον πίνακα ελέγχου

Αποκρίσεις σφαλμάτων

Τα σφάλματα αυθεντικοποίησης επιστρέφουν 401 Unauthorized:

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