Acceso y autorización
Cada aplicación de SP-API se registra en un perfil de desarrollador y solicita roles, como Inventory and Order Tracking o Pricing. Los roles determinan qué operaciones puede llamar. Los que exponen datos personales del comprador, como direcciones de envío, están restringidos y requieren una aprobación adicional.
Vendedores y proveedores conceden acceso a su aplicación mediante Login with Amazon (LWA). Usted guarda un refresh token por cuenta y lo intercambia por access tokens de corta duración. Trate los refresh tokens como contraseñas: cífrelos y manténgalos fuera de los registros.
Los límites de peticiones definen la arquitectura
Cada operación tiene su propio plan de uso: una tasa constante y un margen de ráfaga. Si lo supera, Amazon devuelve HTTP 429. Algunas operaciones ajustan además los límites por cuenta, y las cabeceras de respuesta indican la tasa actual.
- Coloque cada llamada detrás de una cola con un limitador por cuenta y por operación.
- Reintente las respuestas 429 y 5xx con espera exponencial y jitter, nunca en un bucle cerrado.
- Haga idempotentes las escrituras, para que un feed o una actualización reintentados no se apliquen dos veces.
Informes, feeds y llamadas en directo
No toda pregunta necesita una llamada en directo. La Reports API genera archivos masivos (por ejemplo, todos los anuncios, liquidaciones o inventario FBA) de forma asíncrona: se solicita el informe, se espera a que termine y se descarga el documento. La Feeds API y la Listings Items API se encargan de las escrituras masivas e individuales.
Una buena regla: informes para el histórico y los datos masivos, llamadas en directo para las pocas cosas que deben estar al minuto, como un pedido concreto antes de enviarlo.
Notificaciones en lugar de sondeo
La Notifications API envía eventos como cambios de estado de pedidos, cambios de precio o informes terminados a una cola de Amazon SQS o a Amazon EventBridge. Suscribirse elimina la mayor parte del sondeo, ahorra límite para las llamadas que lo necesitan y hace que la integración reaccione antes.
Datos personales y cumplimiento
La Data Protection Policy y la Acceptable Use Policy de Amazon se aplican a toda integración. Los datos personales del comprador solo se devuelven con un token de datos restringidos para la operación concreta, solo pueden conservarse el tiempo necesario (normalmente para el envío y los impuestos) y deben cifrarse en reposo.
En producción
Registre cada petición con su operación, cuenta e ID de petición de Amazon. Configure alertas para tasas crecientes de 429, informes fallidos y colas que dejan de vaciarse. Siga el calendario de retirada de la SP-API: Amazon retira versiones antiguas en fechas anunciadas, y pasar una por alto rompe la integración ese mismo día.
Amazon también ha introducido tarifas para los desarrolladores de SP-API de aplicaciones de terceros. Consulte las condiciones vigentes en la documentación para desarrolladores antes de planificar costes.