Référence Rapide
La plupart des intégrations nécessitent les deux types de clé : une clé Advanced pour la synchronisation de catalogue, les campagnes et le reporting, et une clé Marketplace pour les enchères et les événements.
Quelle Clé Ai-Je Besoin ?
Erreurs Courantes
401 Unauthorized
- Clé API non incluse dans l’en-tête
Authorization - La clé est mal formée ou expirée
- Utilisation d’une clé Advanced sur un endpoint exclusif au Marketplace
Authorization: Bearer YOUR_API_KEY
403 Forbidden
- Utilisation d’une clé Advanced sur un endpoint qui nécessite une clé Marketplace
- Utilisation d’une clé Marketplace sur un endpoint qui nécessite une clé Advanced
Comment Obtenir Vos Clés
Marketplace API Key
1
Accéder à Topsort Admin
Connectez-vous à votre tableau de bord d’administration Topsort
2
Naviguer vers les Paramètres API
Allez dans Paramètres → Intégration API
3
Créer une Clé API
Cliquez sur “Générer une clé API” et sélectionnez “Marketplace API key”
4
Copier et Stocker
Copiez immédiatement la clé et stockez-la en toute sécurité (elle n’est affichée qu’une seule fois)
Advanced API Key
1
Accéder à Topsort Admin
Connectez-vous à votre tableau de bord d’administration Topsort
2
Naviguer vers les Paramètres API
Allez dans Paramètres → Accès API
3
Générer une Clé
Cliquez sur “Générer une Clé” pour créer votre clé Advanced API
4
Copier et Stocker
Copiez la clé et stockez-la en toute sécurité dans vos variables d’environnement
Meilleures Pratiques de Sécurité
- Ne jamais valider les clés dans le contrôle de version
- Stocker les clés dans des variables d’environnement
- Faire pivoter les clés régulièrement
- Utiliser différentes clés pour différents environnements (dev, staging, production)
- Restreindre l’accès aux clés uniquement aux membres nécessaires de l’équipe