Erreurs d’authentification courantes

Si vous rencontrez des difficultés pour vous authentifier auprès de l’API Cathopic, voici les erreurs les plus courantes et comment les corriger.

401 Unauthorized

L’erreur d’authentification la plus courante :

HTTP 401 Unauthorized
{
  "message": "Unauthorized"
}

Causes fréquentes :

• En-tête x-api-key manquant

• Clé API invalide ou expirée

• Erreur de frappe dans la clé API

• Espace avant/après la clé

• Clé non chargée depuis une variable d’environnement

Comment corriger :

1. Vérifiez que le nom de l’en-tête est exactement x-api-key (en minuscules)

2. Copiez à nouveau votre clé API depuis Paramètres → API

3. Vérifiez que les variables d’environnement sont chargées : console.log(process.env.CATHOPIC_API_KEY)

4. Supprimez les espaces : apiKey.trim()

5. Vérifiez que la clé est active (non supprimée ou désactivée)

Mauvais nom d’en-tête

L’API exige x-api-key, et non d’autres noms d’en-tête courants :

// ❌ FAUX
Authorization: Bearer sk_live_abc...
API-Key: sk_live_abc...
apikey: sk_live_abc...
// ✅ CORRECT
x-api-key: sk_live_abc...

Erreur de jeton non autorisé

HTTP 401 Unauthorized
{
  "error": "Unauthorized token"
}

Cause : Votre clé API a été désactivée ou supprimée.

Comment corriger :

• Vérifiez si la clé est toujours active dans Paramètres → API

• Réactivez la clé si elle a été désactivée

• Générez une nouvelle clé si l’ancienne a été supprimée

Variable d’environnement non chargée

Votre code ne trouve pas la clé API :

// Renvoie undefined
const apiKey = process.env.CATHOPIC_API_KEY;
console.log(apiKey); // undefined

Comment corriger :

Node.js :

// Assurez-vous que .env est chargé
require('dotenv').config();
const apiKey = process.env.CATHOPIC_API_KEY;
if (!apiKey) {
  throw new Error('CATHOPIC_API_KEY not set');
}

Python :

import os
from dotenv import load_dotenv
load_dotenv()
api_key = os.environ.get('CATHOPIC_API_KEY')
if not api_key:
    raise ValueError('CATHOPIC_API_KEY not set')

Erreur d’exposition côté client

Vous essayez d’utiliser la clé API dans du JavaScript exécuté dans le navigateur :

// ❌ Cela échouera (les clés ne fonctionnent pas dans les navigateurs)
fetch('https://api.cathopic.com/resources', {
  headers: { 'x-api-key': 'sk_live_abc...' }
});

Comment corriger : Créez un point d’accès côté serveur qui fait office de proxy pour les requêtes vers l’API Cathopic. Consultez « Comment sécuriser mes identifiants ? » pour des exemples.

Erreurs CORS

Si vous voyez des erreurs CORS dans la console du navigateur :

Access to fetch has been blocked by CORS policy...

Cause : Vous essayez d’appeler l’API directement depuis du JavaScript côté client.

Comment corriger : L’API Cathopic est uniquement côté serveur. Vous devez faire passer les requêtes via votre propre backend.

Tester l’authentification

Test rapide pour vérifier votre configuration :

curl -v -X POST https://api.cathopic.com/resources \
  -H "x-api-key: VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"query":"test","page":1,"page_size":1}'
# Recherchez une réponse HTTP 200
# Si 401, vérifiez soigneusement la clé

Checklist de débogage

Si l’authentification échoue encore :

• ☐ Le nom de l’en-tête est x-api-key (sensible à la casse)

• ☐ La clé API est la clé complète (commence par sk_live_ ou similaire)

• ☐ Pas de préfixe Bearer ni de guillemets autour de la clé

• ☐ La variable d’environnement est définie et chargée

• ☐ La requête est envoyée depuis le serveur, pas depuis le navigateur

• ☐ La clé est active dans Paramètres → API

• ☐ Le moyen de paiement est ajouté et valide

Si les problèmes persistent, contactez l’assistance développeurs avec :

• Le message d’erreur

• Les 4 derniers chiffres de votre clé API

• Le langage de programmation et le framework

• Un exemple de code (sans exposer votre clé complète)