Topsort utiliza dos tipos de claves API para diferentes propósitos.
Referencia Rápida
| Tipo de Clave | Propósito |
|---|
| Marketplace API Key | Endpoints de subasta y evento |
| Advanced API Key | Sincronización de catálogo, campañas, informes, facturación |
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?
| Endpoint | Tipo de Clave |
|---|
POST /v2/auctions | Marketplace |
POST /v2/events | Marketplace |
/public/v1/catalog-search-service/* | Advanced |
/public/v1/campaign-service/* | Advanced |
/public/v1/reporting-service/* | Advanced |
/public/v1/billing-service/* | Advanced |
Errores Comunes
401 Unauthorized
{
"error": "Unauthorized",
"message": "Invalid or missing API key"
}
- Clave API no incluida en el encabezado
Authorization
- La clave está mal formada o expirada
- Usando clave Advanced en un endpoint exclusivo de Marketplace
Solución: Verifique el formato del encabezado: Authorization: Bearer YOUR_API_KEY
403 Forbidden
{
"error": "Forbidden",
"message": "Insufficient permissions"
}
- Usando una clave Advanced en un endpoint que requiere una clave Marketplace
- Usando una clave Marketplace en un endpoint que requiere una clave Advanced
Solución: Use el tipo de clave que corresponda al endpoint — consulte ¿Qué Clave Necesito? arriba
Cómo Obtener Sus Claves
Marketplace API Key
Acceder a Topsort Admin
Inicie sesión en su panel de administración de Topsort
Navegar a Configuración de API
Vaya a Configuración → Integración de API
Crear Clave API
Haga clic en “Generar clave API” y seleccione “Marketplace API key”
Copiar y Almacenar
Copie la clave inmediatamente y guárdela de forma segura (solo se muestra una vez)
Advanced API Key
Acceder a Topsort Admin
Inicie sesión en su panel de administración de Topsort
Navegar a Configuración de API
Vaya a Configuración → Acceso a API
Generar Clave
Haga clic en “Generar Clave” para crear su clave Advanced API
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
