Authentification

Toutes les requêtes vers l'API The Trade Hub doivent être authentifiées à l'aide d'une clé API transmise via l'en-tête HTTP X-API-Key.

Obtenir une clé API

Les clés API sont créées depuis le tableau de bord développeur de votre organisation :

1. Connectez-vous à votre compte The Trade Hub
2. Accédez aux paramètres développeur
3. Cliquez sur Créer une clé API
4. Donnez un nom à votre clé et sélectionnez les scopes (classify, export_control)

Format des clés

Toutes les clés API utilisent le préfixe th_live_ suivi de 32 caractères hexadécimaux aléatoires :

th_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Le préfixe affiché dans le tableau de bord (th_live_xxxx) permet d'identifier la clé sans exposer sa valeur complète. La clé complète n'est visible qu'au moment de la création.

Utilisation

Incluez votre clé API dans l'en-tête X-API-Key de chaque requête :

curl -X POST https://api.thetradehub.eu/v1/classify/jobs \
  -H "X-API-Key: th_live_votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{"content": "Casque audio Bluetooth sans fil"}'

import httpx

client = httpx.Client(
    base_url="https://api.thetradehub.eu",
    headers={"X-API-Key": "th_live_votre_cle_api"},
)

response = client.post("/v1/classify/jobs", json={
    "content": "Casque audio Bluetooth sans fil"
})
print(response.json())

const response = await fetch("https://api.thetradehub.eu/v1/classify/jobs", {
  method: "POST",
  headers: {
    "X-API-Key": "th_live_votre_cle_api",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Casque audio Bluetooth sans fil",
  }),
});

const data = await response.json();
console.log(data);

Réponse en cas de clé invalide

Si la clé API est manquante ou invalide, l'API retourne une erreur 401 Unauthorized :

{
  "detail": "Clé API invalide ou manquante"
}

Bonnes pratiques de sécurité

Ne jamais exposer votre clé côté client

Votre clé API ne doit jamais apparaître dans du code frontend (JavaScript navigateur, application mobile). Effectuez toujours les appels API depuis votre serveur backend.

Utiliser des variables d'environnement

Stockez vos clés dans des variables d'environnement, jamais en dur dans le code source :

# .env
TRADEHUB_API_KEY=th_live_votre_cle_api

import os
api_key = os.environ["TRADEHUB_API_KEY"]

Rotation régulière

Renouvelez vos clés API régulièrement :

• Créez une nouvelle clé dans le tableau de bord développeur
• Mettez à jour vos systèmes avec la nouvelle clé
• Supprimez l'ancienne clé une fois la migration terminée

Permissions minimales

Créez des clés dédiées par service ou application. En cas de compromission, seule la clé concernée doit être révoquée.

Surveillance

Surveillez l'activité de vos clés API depuis le tableau de bord. Des requêtes inhabituelles (volume anormal, endpoints non utilisés) peuvent indiquer une fuite.