Referencia Rápida
| Tipo de Clave | Dónde | Propósito | Usuario |
|---|---|---|---|
| Marketplace API Key | Configuración de Admin | Todas las operaciones del marketplace | Servidores backend |
| Advanced API Key | Panel de Vendedor | Campañas de un solo vendedor | Herramientas de vendedor |
¿Qué Clave Necesito?
| Endpoint | Tipo de Clave |
|---|---|
POST /v2/auctions | Marketplace |
POST /v2/events | Marketplace |
POST /v2/products | Marketplace |
GET /public/v1/reporting-service/* | Marketplace |
POST /public/v1/campaign-service/* | Cualquiera (con alcance de vendedor si es clave Advanced) |
GET /public/v1/billing-service/* | Marketplace |
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 clave Advanced para un endpoint que requiere clave Marketplace
- La clave Advanced intenta acceder a datos de un vendedor diferente
Cómo Obtener Sus Claves
Marketplace API Key
Advanced API Key
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
Alcance de Permisos de Clave
Marketplace API Key
- Acceso completo a todas las operaciones del marketplace
- Puede crear y administrar campañas para cualquier vendedor
- Acceso a todos los datos de informes
- Requerida para endpoints de subastas y eventos
Advanced API Key
- Limitada a los datos de un vendedor específico
- Solo puede administrar campañas para el vendedor asociado
- No puede acceder a información de otros vendedores
- Ideal para integraciones específicas de vendedor
Last updated: