Referencia Rápida
La mayoría de las integraciones necesitan ambos tipos de clave: una clave Advanced para la sincronización de catálogo, campañas e informes, y una clave Marketplace para subastas y eventos.
¿Qué Clave Necesito?
Errores Comunes
401 Unauthorized
- Clave API no incluida en el encabezado
Authorization - La clave está mal formada o expirada
- Usando clave Advanced en un endpoint exclusivo de Marketplace
Authorization: Bearer YOUR_API_KEY
403 Forbidden
- Usando una clave Advanced en un endpoint que requiere una clave Marketplace
- Usando una clave Marketplace en un endpoint que requiere una clave Advanced
Cómo Obtener Sus Claves
Marketplace API Key
1
Acceder a Topsort Admin
Inicie sesión en su panel de administración de Topsort
2
Navegar a Configuración de API
Vaya a Configuración → Integración de API
3
Crear Clave API
Haga clic en “Generar clave API” y seleccione “Marketplace API key”
4
Copiar y Almacenar
Copie la clave inmediatamente y guárdela de forma segura (solo se muestra una vez)
Advanced API Key
1
Acceder a Topsort Admin
Inicie sesión en su panel de administración de Topsort
2
Navegar a Configuración de API
Vaya a Configuración → Acceso a API
3
Generar Clave
Haga clic en “Generar Clave” para crear su clave Advanced API
4
Copiar y Almacenar
Copie la clave y guárdela de forma segura en sus variables de entorno
Mejores Prácticas de Seguridad
- Nunca confirme claves en el control de versiones
- Almacene claves en variables de entorno
- Rote las claves regularmente
- Use claves diferentes para diferentes entornos (dev, staging, producción)
- Restrinja el acceso a las claves solo a los miembros del equipo necesarios