Amazon ha puesto fin a la antigua versión de su API de publicidad de productos: la versión 4 (API 4) ya no existe. Si eres como yo… ¡ni siquiera sabías que la API tenía diferentes versiones! Yo ni siquiera sabía que existían las versiones 1 a 3 y, desde luego, no sabía que la versión actual que había estado utilizando durante muchos años era la 4. No obstante, La API 4 finalizó bruscamente el 31 de octubre de 2019, y Amazon está obligando a todos los usuarios de la API a pasar a la nueva versión: API 5 (técnicamente conocida como pa-api 5.0 o la API de publicidad de productos de Amazon 5.0).
Don’t worry, the switch is painless.
Entonces, ¿qué es la API 5 de Amazon?
La API 5 es simplemente la última versión mejorada y actualizada de la API de Amazon.
La API nos permite, como Asociados de Amazon, conectar nuestros sitios web a las bases de datos de Amazon para mostrar información sobre los productos que se venden en Amazon en nuestros propios sitios web.
Aquí tienes la sección de preguntas frecuentes de la documentación completa de la API 5 de Amazon – https://webservices.amazon.com/paapi5/documentation/faq.html
¿Cómo afectará esto a mi sitio web que se conecta a la API?
A partir del 31 de octubre de 2019, la antigua API 4 dejará de funcionar por completo y, si tu sitio sigue utilizando la API 4, los enlaces de Amazon que utilicen la API dejarán de funcionar.
Debes actualizar a la API 5 el 31 de octubre de 2019 o antes.
Esto significa que cualquier plugin o herramienta que utilices debe actualizar su código para ser compatible con la nueva API 5.
No te preocupes: si utilizas AmaLinks Pro® para conectarte a Amazon a través de la API, no tendrás ningún problema.
Estamos al tanto de esto y nuestra versión actualizada se publicará antes del 31 de octubre de 2019.
Pero sigue leyendo, porque hay pasos que debes dar para asegurarte de que eres compatible con la API 5.
Actualización: 22 de enero de 2020
Parece que Amazon envió un correo electrónico a todos los Asociados de Amazon el 22 de enero de 2020 advirtiendo de que PA-API 4 se cerrará el 9 de marzo de 2020.
Esto es nuevo para nosotros, ya que pensábamos que lo habían cerrado completamente el 31 de octubre de 2019.
Eso es exactamente lo que nos dijeron…
Aquí tienes una imagen de lo que enviaron por correo electrónico el 22 de enero de 2020.
¿Cómo actualizo a la API 5 de Amazon?
Como usuario de AmaLinks Pro®, hay tres cosas que debes confirmar o hacer para ser compatible con la API 5.
- Confirma que tus claves API de Amazon son compatibles con la API 5
- Confirma que tienes las claves API de Amazon adecuadas insertadas y activadas en tu plugin
- Confirma que estás ejecutando la última versión actualizada del plugin
¡Importante!
DEBES tener una suscripción actual y activa a AmaLinks Pro® para recibir actualizaciones del complemento.
Si estás utilizando AmaLinks Pro® v 1.4.4 (o anterior) o el complemento Table Builder v 1.2.4 (o anterior), tu conexión a la API de Amazon no funcionará.
Debes actualizarte a las versiones más recientes para ser compatible con la API 5.
¿Cómo sé si mis credenciales API son compatibles con la API 5?
Si tus credenciales se generaron después del 30 de septiembre de 2017, puedes continuar y no tienes que hacer nada.
Si tus credenciales se generaron antes del 30 de septiembre de 2017, es absolutamente necesario que generes nuevas credenciales.
De hecho, yo entro en esta categoría, así que te mostraré exactamente cómo hacerlo.
Esta es la historia en pocas palabras.
En el pasado, las credenciales API se generaban a través de Amazon Web Services (AWS).
Aquí es donde generé mis claves API de afiliado de Amazon hace muchos años y he estado utilizando las mismas credenciales desde entonces.
30 de septiembre de 2017 – esta debe haber sido la fecha en la que trasladaron el proceso para generar las credenciales API a la derecha dentro del panel de control de Amazon Associates.
Básicamente, si creaste tus credenciales de la API desde el panel de control de Amazon Associates (menú Herramientas > API de publicidad de productos), probablemente estés listo.
Si creaste tus credenciales API en AWS hace más de 2 años, probablemente necesites actualizarlas.
Si no estás seguro de tus credenciales, puedes probar a jugar con el«Scratchpad» de Amazon para ver si tus credenciales funcionan.
- Para comprobar si tus credenciales son compatibles con PA API 5.
Utiliza la opción «Iniciar recorrido» para obtener un recorrido por el Bloc de notas.
Si tienes alguna duda, consulta la sección Guía de uso del Bloc de notas. - Si recibes una «AccessDeniedException» con el código «AccessDeniedAwsUsers», significa que necesitas actualizar tus credenciales.
Cómo actualizar tus credenciales de la API de Amazon
Si tus claves API de Amazon se generaron en AWS (como las mías), simplemente sigue estos pasos…
- Accede a tu cuenta de Amazon Associates
- En el menú Herramientas – haz clic en API de publicidad de productos
- Desplázate hacia abajo hasta donde dice «Gestionar tus credenciales» y luego haz clic en el botón Migrar
- Pulsa el botón Continuar en la siguiente ventana emergente
- Haz clic en el botón para Descargar tus credenciales
- Asegúrate de guardar este archivo en un lugar seguro donde no lo pierdas
- Nunca podrás volver a ver estas credenciales online – si las pierdes, tendrás que volver a generar nuevas credenciales
- Sustituye tus antiguas credenciales por estas nuevas en cualquier aplicación o herramienta que utilices que requiera claves API de Amazon.
- Prueba tus nuevas claves API de Amazon (con AmaLinks Pro® – simplemente haz clic en el botón Probar conexión API de Amazon debajo de las credenciales)
¿Mis claves de la API 5 seguirán funcionando con la API 4?
Sí.
Puedes y debes actualizar tus credenciales API a las nuevas claves API 5 lo antes posible.
Incluso si tu software o aplicaciones aún no están actualizados para ser compatibles con la API 5, las nuevas claves funcionarán tanto con la API 4 como con la API 5.
¿Funciona AmaLinks Pro® con la API 5 de Amazon?
Hemos sido conscientes de este próximo cambio y hemos estado codificando y probando enérgicamente, y luego probando y codificando para asegurarnos de que AmaLinks Pro® será absolutamente compatible con la API 5 a más tardar el 31 de octubre de 2019.
Hacer estos cambios no ha sido una tarea fácil y nos ha llevado muchas horas de codificación.
Pero al final, vemos claramente cómo la nueva API 5 mejorará enormemente la experiencia en todos los niveles de usuario durante los próximos años.
La versión 1.4.4 (o anterior) de AmaLinks Pro® NO será compatible con la API 5.
Asegúrate de descargar o actualizar a la versión más reciente.
La versión 1.2.4 (o anterior) de AmaLinks Pro® NO será compatible con la API 5.
Asegúrate de descargar o actualizar a la versión más reciente. De nuevo – Los usuarios de AmaLinks Pro® DEBEN tener una suscripción actual y activa para poder recibir actualizaciones importantes del plugin como ésta. Si tienes una versión antigua de AmaLinks Pro® y una licencia inactiva, tendrás que adquirir una suscripción para recibir esta importante actualización. Nota: Amazon nos obliga a hacer estos cambios y no lo hacemos sólo para vender más suscripciones.
Preguntas frecuentes – API 5
De nuevo, te animo a que te dirijas a la página de documentación oficial de la API 5 en Amazon y leas las FAQ.
Se responderán todas tus preguntas y muchas más, incluidas algunas de las siguientes…
- Estoy utilizando PA API 4.
¿Por qué tengo que actualizarme a una versión más reciente de PA API? - ¿Cuál es el valor empresarial de pasar de PA API 5 a Asociado?
- ¿Cuál es la ventaja técnica de actualizar a la PA API 5 como desarrollador?
- Si hoy soy usuario de la PA API, ¿qué tengo que hacer para actualizarme a la PA API 5?
- ¿Significa esto que para actualizar mi sitio PA API 4 a PA API 5, tendré que actualizar mi sitio o aplicación?
- ¿Cuánto esfuerzo y tiempo serán necesarios para pasar de PA API 4 a PA API 5?
- ¿Necesito nuevas credenciales para acceder a la PA API 5 o puedo utilizar las antiguas?
- No recuerdo si he generado nuevas credenciales.
¿Cómo sé si tengo credenciales antiguas o nuevas? - ¿Puedo utilizar las nuevas credenciales para acceder a la PA API 4?
- Si he actualizado a PA API 5, ¿puedo volver a PA API 4?
- Cuando actualizo a PA API 5, ¿se aplican las directrices de eficiencia? (Pista: la respuesta es sí)
- Nunca he utilizado PA API.
¿Qué tengo que hacer para utilizar PA API 5? - Tengo preguntas o comentarios.
¿Cómo puedo obtener ayuda adicional?
La mayoría de estas preguntas ya están contestadas en este Post anterior – pero si quieres ver las respuestas de Amazon a estas preguntas específicas, asegúrate de dirigirte allí y leer. https://webservices.amazon.com/paapi5/documentation/faq.html