API Ahead

Boletín semanal · gratis · para developers de la Amazon SP-API

Entérate de lo que Amazon cambió en la SP-API antes de que rompa tu integración.

Cada lunes, un diff exacto de los modelos OpenAPI que publica Amazon, clasificado en lo que rompe, lo que rompe en silencio, lo que se retira y lo que se añade. Sin scraping y sin adivinar: si está aquí, está en el spec.

Doble confirmación · Baja en un clic · Ni spam ni listas compradas

Una edición real, no un mockup · mayo–agosto de 2026

API Ahead · Amazon SP-API · 27 may – 26 ago 2026

3 rompen · 3 de riesgo silencioso · 94 aditivos · 14 modelos de API tocados

  • awd_2024-05-09

    Valores LETTER_6 y THERMAL_NONPCP retirados del parámetro pageType.

  • orders_2026-01-01

    ItemProceedsBreakdown.subtotal pasa a obligatorio.

  • orders_2026-01-01

    ItemProceedsBreakdown.type pasa a obligatorio.

  • listingsItems_2021-08-01

    10 valores de Issue.categories documentados por primera vez.

  • orders_2026-01-01

    Nuevo valor FULFILLMENT_ORDERS en includedData (×2 endpoints).

Cómo funciona

Un diff de ficheros versionados. Determinista, exacto y sin alucinaciones.

  1. 01

    Amazon publica sus modelos

    Los modelos OpenAPI de toda la Selling Partner API viven en un repositorio público de Amazon. Cada cambio real de la API pasa por ahí, con su commit y su fecha.

  2. 02

    Cada modelo se aplana en hechos

    En vez de comparar dos JSON anidados, cada documento se convierte en afirmaciones planas con claves estables. Comparar dos versiones se reduce a comparar dos diccionarios.

    field Order.OrderStatus              -> string|required=True
enum  Issue.categories[]             -> ('DUPLICATE', 'INVALID_IMAGE', ...)
param GET /orders :: includedData    -> array<string>|required=False|in=query
  3. 03

    Cada diferencia se clasifica y se redacta

    Rompe, riesgo silencioso, deprecación o aditivo. Y después, para cada cambio que importa: qué cambió, qué rompe en la práctica y qué buscar en tu código. Escrito para un developer con prisa.

Las cuatro categorías

No todo lo que cambia rompe. Lo que rompe no siempre avisa.

Rompe Falla de forma ruidosa: endpoint o campo eliminado, parámetro que pasa a obligatorio, valor de enum retirado.
Riesgo silencioso No falla al desplegar. Falla en producción, semanas después, sobre parte de tus registros.
Deprecación Retirada anunciada. Hay tiempo, pero hay fecha.
Aditivo Superficie nueva. No rompe nada.

La naranja es la que nos diferencia: un switch con los valores conocidos no falla al desplegar, falla la primera vez que Amazon envía el valor nuevo.

Para quién

Para quien mantiene código contra la SP-API.

Agencias e integradores que mantienen N integraciones de N clientes. Un cambio de Amazon les multiplica el trabajo por N, y el primer aviso suele ser un cliente enfadado.

ISVs y SaaS del ecosistema cuyo producto es la integración. Si se rompe, no es un bug: es un incidente de producto.

Equipos con un developer in-house que además hace otras diez cosas y no tiene un hueco cada semana para leerse el changelog.

No es para el vendedor que usa una herramienta ya hecha: esa herramienta ya tiene a alguien mirando esto por él. Es para ese alguien.

Lo que viene

El siguiente nivel: tu repositorio, tu fichero, tu línea.

Estamos construyendo el siguiente nivel: conectas tu repositorio en modo lectura y te decimos qué fichero y qué línea toca cada cambio, con una pull request propuesta. Tu código no sale de tu casa y nadie escribe en tu producción.

Si quieres estar en la lista de pilotos, suscríbete y responde al primer correo.

Cada lunes, antes de que empiece tu semana.

Sin coste. Sin API keys. Sin acceso a tu código.

Doble confirmación · Baja en un clic · Ni spam ni listas compradas