Amazon a mis fin à l’ancienne version de son API de publicité sur les produits – la version 4 (API 4) n’existe plus. Si tu es comme moi… tu ne savais même pas que l’API avait différentes versions ! Je ne savais même pas que les versions 1 à 3 existaient et je ne savais certainement pas que la version actuelle que j’utilisais depuis de nombreuses années était la version 4. Quoi qu’il en soit, L’API 4 a pris fin brutalement le 31 octobre 2019, et Amazon oblige tous les utilisateurs de l’API à passer à la nouvelle version – API 5 (connue techniquement sous le nom de pa-api 5.0 ou l’API 5.0 de publicité sur les produits Amazon).
Don’t worry, the switch is painless.
Alors, qu’est-ce que l’API 5 d’Amazon ?
API 5 est tout simplement la dernière version améliorée et mise à jour de l’API d’Amazon.
L’API nous permet, en tant qu’associés d’Amazon, de connecter nos sites Web aux bases de données d’Amazon afin d’afficher sur nos propres sites Web des informations sur les produits vendus sur Amazon.
Voici la section FAQ de la documentation complète de l’API 5 d’Amazon – https://webservices.amazon.com/paapi5/documentation/faq.html
Comment cela affectera-t-il mon site Web qui se connecte à l’API ?
À partir du 31 octobre 2019 – l’ancienne API 4 sera complètement arrêtée et si ton site utilise encore l’API 4, tes liens Amazon qui utilisent l’API ne fonctionneront plus.
Tu dois faire la mise à jour vers l’API 5 au plus tard le 31 octobre 2019.
Cela signifie que tout plugin ou outil que tu utilises doit mettre à jour son code pour être compatible avec la nouvelle API 5.
Ne t’inquiète pas – si tu utilises AmaLinks Pro® pour te connecter à Amazon via l’API – tout ira bien.
Nous sommes au courant et notre version mise à jour sera publiée avant le 31 octobre 2019.
Mais continue de lire, car il y a des étapes que tu dois suivre de ton côté pour être sûr d’être compatible avec l’API 5.
Mise à jour : 22 janvier 2020
Il semble qu’Amazon ait envoyé un courriel à tous les associés Amazon le 22 janvier 2020 pour les avertir que PA-API 4 sera fermé le 9 mars 2020.
C’est une nouvelle pour nous – car nous pensions qu’ils l’avaient complètement fermé le 31 octobre 2019 ! !!
C’est exactement ce qu’ils nous ont dit, en tout cas….
Voici une image de ce qu’ils ont envoyé par courriel le 22 janvier 2020.
Comment passer à l’API 5 d’Amazon ?
En tant qu’utilisateur d’AmaLinks Pro®, il y a trois choses que tu dois confirmer ou faire pour être compatible avec l’API 5.
- Confirme que tes clés API Amazon sont compatibles avec l’API 5
- Confirme que tu as les bonnes clés API Amazon insérées et activées dans ton plugin.
- Confirme que tu utilises la dernière version mise à jour du plugin.
Important !
Tu DOIS avoir un abonnement actuel et actif à AmaLinks Pro® pour recevoir les mises à jour du plugin.
Si tu utilises AmaLinks Pro® v 1.4.4 (ou une version antérieure) ou le module complémentaire Table Builder v 1.2.4 (ou une version antérieure), ta connexion à l’API Amazon ne fonctionnera pas.
Tu dois mettre à jour les versions les plus récentes afin d’être compatible avec l’API 5.
Comment puis-je savoir si mes identifiants API sont compatibles avec l’API 5 ?
Si tes identifiants ont été générés après le 30 septembre 2017 – tout va bien et tu n’as pas besoin de faire quoi que ce soit.
Si tes identifiants ont été générés avant le 30 septembre 2017 – alors tu dois absolument générer de nouveaux identifiants.
En fait, je fais partie de cette catégorie – je vais donc te montrer exactement comment procéder.
Voici l’histoire en quelques mots.
Dans le passé, les identifiants d’API étaient générés par l’intermédiaire d’Amazon Web Services (AWS).
C’est là que j’ai généré mes clés API d’affiliation Amazon il y a de nombreuses années et j’utilise les mêmes identifiants depuis.
Le 30 septembre 2017 – ce doit être la date à laquelle ils ont déplacé le processus de génération des identifiants API à droite dans le tableau de bord Amazon Associates.
En gros, si tu as créé tes identifiants API depuis ton tableau de bord Amazon Associates (menu Outils > Product Advertising API), alors tu es probablement en mesure de le faire.
Si tu as créé tes identifiants API sur AWS il y a plus de deux ans, tu dois probablement les mettre à jour.
Si tu n’es pas sûr de tes informations d’identification, tu peux essayer de jouer avec le« Scratchpad » d’Amazon pour voir si tes informations d’identification fonctionnent.
- Pour vérifier si tes informations d’identification sont compatibles avec PA API 5.
Utilise l’option « Démarrer la visite » pour faire une visite guidée du Scratchpad.
Si tu as des questions, reporte-toi à la section Guide d’utilisation du Scratchpad. - Si tu obtiens « AccessDeniedException » avec le code « AccessDeniedAwsUsers », cela signifie que tu dois mettre à jour tes informations d’identification.
Comment mettre à jour tes identifiants API Amazon
Si tes clés API Amazon ont été générées sur AWS (comme les miennes), suis simplement ces étapes…
- Connecte-toi à ton compte Amazon Associates
- Dans le menu Outils, clique sur API pour la publicité sur les produits.
- Fais défiler la page jusqu’à l’endroit où il est écrit « Gérer tes informations d’identification », puis clique sur le bouton Migrer.
- Clique sur le bouton continuer dans la fenêtre contextuelle suivante.
- Clique sur le bouton pour télécharger tes informations d’identification.
- Veille à enregistrer ce fichier dans un endroit sûr où tu ne le perdras pas
- Tu ne pourras plus jamais consulter ces informations d’identification en ligne – si tu les perds, tu devras à nouveau générer de nouvelles informations d’identification
- Remplace tes anciens identifiants par ces nouveaux dans toutes les applications ou outils que tu utilises et qui nécessitent des clés API Amazon.
- Teste tes nouvelles clés API Amazon (avec AmaLinks Pro® – il suffit de cliquer sur le bouton Tester la connexion API Amazon sous les informations d’identification).
Mes clés API 5 continueront-elles à fonctionner avec API 4 ?
Oui.
Tu peux et tu dois mettre à jour tes identifiants API avec les nouvelles clés API 5 dès que possible.
Même si ton logiciel ou tes applications ne sont pas encore mis à jour pour être compatibles avec l’API 5 – les nouvelles clés fonctionneront avec l’API 4 et l’API 5.
AmaLinks Pro® fonctionne-t-il avec Amazon API 5 ?
Nous étions au courant de ce changement à venir et nous avons vigoureusement codé et testé, puis testé et codé pour nous assurer qu’AmaLinks Pro® sera absolument compatible avec l’API 5 au plus tard le 31 octobre 2019.
Apporter ces changements n’a pas été une mince affaire et il a fallu de nombreuses heures de codage pour que cela fonctionne.
Mais au final, nous voyons clairement comment la nouvelle API 5 améliorera considérablement l’expérience à tous les niveaux d’utilisation pour les années à venir.
La version 1.4.4 (ou antérieure) d’AmaLinks Pro® ne sera PAS compatible avec l’API 5.
Assure-toi de télécharger ou de mettre à jour la version la plus récente.
La version 1.2.4 (ou antérieure) d’AmaLinks Pro® n’est PAS compatible avec l’API 5.
Veille à télécharger ou à mettre à jour la version la plus récente. Encore une fois, les utilisateurs d’AmaLinks Pro® DOIVENT avoir un abonnement actif et à jour pour recevoir les mises à jour importantes du plugin comme celle-ci. Si tu as une ancienne version d’AmaLinks Pro® et une licence inactive – tu devras acheter un abonnement pour recevoir cette importante mise à jour. Remarque : Amazon nous oblige à faire ces changements et nous ne faisons pas cela uniquement pour vendre plus d’abonnements.
Foire aux questions – API 5
Encore une fois, je t’encourage à te rendre sur la page de documentation officielle d’Amazon pour l’API 5 et à lire la FAQ.
Tu y trouveras les réponses à toutes tes questions et à bien d’autres, y compris les suivantes…
- J’utilise PA API 4.
Pourquoi dois-je passer à une version plus récente de PA API ? - Quelle est la valeur commerciale du passage de PA API 5 à Associate ?
- Quel est l’avantage technique de passer à PA API 5 en tant que développeur ?
- Si je suis déjà un utilisateur de PA API, que dois-je faire pour passer à PA API 5 ?
- Cela signifie-t-il que pour mettre à niveau mon site PA API 4 vers PA API 5, je devrai mettre à jour mon site ou mon application ?
- Combien d’efforts et de temps seront nécessaires pour passer de PA API 4 à PA API 5 ?
- Ai-je besoin de nouvelles informations d’identification pour accéder à PA API 5 ou puis-je utiliser mes anciennes informations ?
- Je ne me souviens pas si j’ai généré de nouvelles informations d’identification.
Comment puis-je savoir si j’ai d’anciennes ou de nouvelles informations d’identification ? - Puis-je utiliser les nouveaux identifiants pour accéder à PA API 4 ?
- Si j’ai effectué une mise à niveau vers PA API 5, puis-je revenir à PA API 4 ?
- Lorsque je passe à PA API 5, les directives d’efficacité s’appliquent-elles ? (Indice : la réponse est oui)
- Je n’ai jamais utilisé PA API.
Que dois-je faire pour utiliser PA API 5 ? - J’ai des questions ou des commentaires.
Comment puis-je obtenir de l’aide supplémentaire ?
La plupart de ces questions ont déjà trouvé une réponse dans le billet ci-dessus – mais si tu veux voir les réponses d’Amazon à ces questions spécifiques, n’hésite pas à te rendre sur place et à lire la suite. https://webservices.amazon.com/paapi5/documentation/faq.html