Recruter un développeur Amazon SP-API : les points à vérifier
Vous recrutez un développeur Amazon SP-API ? Vérifiez la propriété du compte, les API bientôt retirées et les questions qui révèlent les profils faibles.
Long Nguyen
Développeur fullstack · Ingénieur IA · Chercheur
Ce qu’il faut vérifier avant de recruter un développeur Amazon SP-API
Appeler un endpoint REST est la partie la plus simple : n’importe quel développeur backend peut le faire. Les problèmes qui surviennent en production sont d’un autre ordre et tiennent à quatre éléments : qui est propriétaire de l’enregistrement développeur, si le développement repose sur des API qu’Amazon est en train de retirer, comment l’intégration se comporte lorsqu’Amazon la limite et comment elle traite les données des acheteurs.
Ce guide sert de checklist pour ces quatre points. Il est conçu pour qu’un dirigeant ou un responsable des opérations puisse mener l’entretien de recrutement sans parcourir la documentation de référence des API. Les informations ci-dessous ont été vérifiées à partir de la documentation officielle d’Amazon le .
- Propriété : le profil développeur et les identifiants de l’application sont dans votre compte, pas dans celui du prestataire.
- Actualité : tout nouveau développement repose sur les versions actuelles des API, et non sur celles qui disposent d’une date de retrait.
- Résilience : la gestion de la limitation est prévue dès la conception, et non découverte après le lancement.
- Gestion des données : seuls les rôles nécessaires au projet sont demandés et les identifiants sont correctement gérés.
Quand avez-vous réellement besoin d’un développeur SP-API ?
La Selling Partner API (SP-API) est l’API REST d’Amazon qui permet d’accéder par programmation aux données d’un vendeur : offres, commandes, paiements, rapports et bien plus encore. Vous avez besoin d’un développeur lorsqu’un connecteur prêt à l’emploi ne permet pas d’exprimer votre logique, par exemple pour gérer un routage personnalisé des stocks entre plusieurs entrepôts, envoyer les commandes vers votre propre ERP ou créer un outil destiné à d’autres vendeurs. Si un connecteur existant couvre déjà votre flux de données, un développement personnalisé peut devenir une charge de maintenance dont vous n’avez pas besoin.
Le tableau ci-dessous met en relation les tâches courantes, les domaines d’API concernés et les difficultés les plus fréquentes.
| Ce que vous souhaitez automatiser | Domaine SP-API concerné | Point de difficulté |
|---|---|---|
| Transférer les commandes vers votre ERP ou votre système d’entrepôt | Orders API, Notifications API | Gestion des données personnelles des acheteurs, renommage des valeurs de statut et expiration des jetons de pagination |
| Mettre à jour en masse les offres, les prix et les stocks | Listings Items API, JSON-based Feeds API, Product Type Definitions API | Les règles d’attributs varient selon le type de produit et la marketplace, et les problèmes de validation sont signalés pour chaque offre : il faut donc gérer les erreurs, pas seulement afficher un succès ou un échec |
| Gérer les frais, les versements et le rapprochement comptable | Finances API, Reports API | Finances v0 et les rapports de règlement V2 figurent tous deux au calendrier de retrait d’Amazon |
| Automatiser les réceptions entrantes FBA | Fulfillment Inbound API | Les anciennes opérations entrantes v0 ont été retirées en janvier 2025 : les anciens tutoriels et exemples de code ne fonctionnent donc plus |
À qui appartient le compte développeur SP-API ?
Pour appeler SP-API, vous devez disposer d’un profil développeur dans l’Amazon Solution Provider Portal et d’une application enregistrée. Amazon distingue deux types de développeurs. Un développeur privé crée des applications qui intègrent uniquement sa propre entreprise à Amazon ; ces applications sont autorisées automatiquement. Un développeur public crée des applications pour d’autres vendeurs, et les applications publiques sont soumises à leurs propres limites d’autorisation.
Si vous recrutez quelqu’un pour votre propre boutique, vous devez être le développeur privé. Trois points sont essentiels lors de cet échange :
- Seul l’utilisateur principal du compte peut terminer l’enregistrement. Un prestataire ne peut pas s’enregistrer à votre place depuis son propre compte : le propriétaire doit donc participer à la démarche.
- La décision d’approbation appartient à Amazon. Elle repose sur votre profil développeur, notamment sur la fonction de l’application et sa conformité avec l’Acceptable Use Policy et la Data Protection Policy. Amazon précise qu’il ne peut pas détailler la manière dont l’éligibilité est déterminée. Amazon vous demande également de limiter le profil à 500 mots, de le rédiger avec vos propres formulations plutôt que de copier le texte des politiques, et de faire répondre votre équipe technique aux questions de sécurité.
- Les rôles restreints impliquent des données personnelles. Les rôles qui donnent accès à des informations permettant d’identifier une personne déclenchent un examen plus strict. Pour les développeurs publics, cela comprend un examen de l’architecture avec l’équipe SP-API Solutions Architecture d’Amazon, qui peut inclure une démonstration en partage d’écran.
L’approbation étant une étape dépendant d’un tiers, rédigez des jalons qui ne supposent pas une date d’approbation précise. Demandez au candidat de préparer le texte décrivant le cas d’usage avec vous et conservez l’enregistrement de l’application ainsi que les identifiants dans votre propre compte. Amazon propose une gestion des utilisateurs dans l’Amazon Solution Provider Portal : le développeur doit donc travailler avec son propre utilisateur, et non avec une connexion principale partagée. Les identifiants doivent également être renouvelés régulièrement, et Amazon propose des notifications de renouvellement via son Application Management API.
Méfiez-vous des propositions qui indiquent : nous utiliserons notre propre compte développeur pour votre boutique. Il peut s’agir d’un montage légitime avec une application publique, mais vous louez alors l’accès au lieu d’en être propriétaire : si la relation prend fin, votre intégration reste liée à leur application.
Les évolutions d’API qu’un développeur compétent connaît déjà
Amazon publie un calendrier de retrait de SP-API avec les dates de suppression. Dans ce calendrier, deprecated signifie que la ressource n’est plus activement développée, tandis que removed signifie que les appels échoueront à partir de la date de retrait. Le calendrier a été modifié pour la dernière fois le . Voici les entrées importantes pour un nouveau développement, avec leur statut au :
| Domaine | Élément retiré | Date de retrait | Statut |
|---|---|---|---|
| Feeds API | Types de flux d’offres XML et flat-file, notamment POST_PRODUCT_DATA et POST_FLAT_FILE_LISTINGS_DATA | Retiré | |
| Notifications API | ORDER_STATUS_CHANGE | Retiré | |
| Notifications API | LISTINGS_ITEM_ISSUES_CHANGE, version de payload 1.0 | Retiré | |
| Reports API | Rapports de règlement V2 (GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE et _XML) | À venir | |
| Orders API | Orders v0 (opérations getOrders, getOrder, getOrderItems, informations sur l’acheteur et opérations d’adresse) | À venir | |
| Finances API | Finances v0 (opérations listFinancialEvents) | À venir |
Ce qui change avec le passage d’Orders v0 à v2026-01-01
Orders est l’API que la plupart des intégrations utilisent en premier. C’est donc la migration qui risque le plus de vous incomber. Le remplacement est Orders API v2026-01-01, et les différences vont bien au-delà du renommage des appels :
| Orders v0 | Orders v2026-01-01 |
|---|---|
| GetOrders | searchOrders |
| GetOrder et GetOrderItems | getOrder, avec les articles toujours inclus |
| GetOrderBuyerInfo, GetOrderAddress | getOrder avec includedData=BUYER ou RECIPIENT |
| Pagination avec NextToken | paginationToken, qui expire après 24 heures |
| Valeurs de statut comme Canceled ; valeurs de canal MFN et AFN | CANCELLED, ainsi que MERCHANT et AMAZON : tout mapping des statuts devient donc silencieusement incorrect s’il n’est pas mis à jour |
| Restricted Data Token nécessaire pour les données personnelles | Rôles uniquement ; aucun Restricted Data Token pour les données personnelles Orders |
| Filtre BuyerEmail | Non disponible |
Deux conséquences pratiques en découlent. Premièrement, une intégration existante basée sur Orders v0 ou sur des flux XML constitue un projet de migration avec une échéance ferme, et non une petite correction : il faut donc la chiffrer et la planifier en conséquence. Deuxièmement, toute nouvelle proposition reposant sur v0 ou sur des flux XML indique que le candidat travaille à partir d’anciens tutoriels.
Autre indice révélateur : depuis le , SP-API n’exige plus AWS IAM ni AWS Signature Version 4 pour appeler l’API. Une proposition qui prévoit plusieurs jours pour configurer des rôles IAM et signer les requêtes simplement pour effectuer les appels est obsolète. AWS reste toutefois utilisé si vous vous servez d’Amazon SQS ou d’EventBridge pour recevoir les notifications. La réponse exacte est donc que l’IAM a quitté le chemin des requêtes, pas l’architecture.
Combien coûte un développeur Amazon SP-API en 2026 ?
Il faut distinguer deux postes de coût, dont le premier a diminué cette année. En novembre 2025, Amazon a annoncé des frais développeur pour SP-API : un abonnement annuel auquel s’ajoutaient des frais d’utilisation calculés selon le volume d’appels GET. Le , Amazon a informé les développeurs qu’il ne mettrait pas en œuvre les frais d’utilisation et l’abonnement annuel pour le moment. À la date de cet article, aucun frais facturé par Amazon n’est donc à prévoir.
Considérez l’expression pour le moment comme une raison de demander aux candidats comment leur conception résisterait à une tarification par appel. Une intégration qui s’appuie sur les notifications plutôt que sur une interrogation programmée coûte moins cher à exploiter, quel que soit le modèle tarifaire. Les recommandations d’Amazon pour les applications soumises à la limitation vont dans le même sens : utilisez les notifications push plutôt que le polling.
Le second poste correspond aux honoraires du développeur. Plutôt que de citer des tarifs qui deviennent vite obsolètes, voici les éléments qui font réellement varier le prix :
| Facteur de coût | Pourquoi il modifie le périmètre |
|---|---|
| Nombre de flux de données | Les commandes, les stocks, les offres et les finances utilisent des API, des règles et des modes d’échec distincts |
| Marketplaces et régions | Les plans d’utilisation et les autorisations sont liés aux groupes de boutiques, et les identifiants provenant d’un compte régional différent disposent de leurs propres limites |
| Données personnelles des acheteurs et rôles restreints | Examen plus strict, gestion des données plus rigoureuse et documentation de sécurité plus importante |
| Synchronisation en temps réel ou planifiée | Les notifications nécessitent une infrastructure de file d’attente ou d’événements ; le polling exige une gestion précise de la limitation |
| Migration d’un développement existant | Orders v0, les flux XML et Finances v0 doivent tous être remaniés conformément au calendrier ci-dessus |
| Maintenance continue | Le calendrier prévoit des dates de retrait en 2025, 2026 et 2027 : le travail n’est donc jamais complètement terminé |
Demandez un devis fondé sur un périmètre écrit. Un tarif horaire sans périmètre défini vous fait supporter le risque de toutes les surprises mentionnées dans ce tableau. Si vous préférez être accompagné pour définir le périmètre, le service d’intégration marketplace de Netalith couvre les offres, les stocks, les commandes et le suivi Amazon SP-API, avec un prix établi selon vos flux de données.
Les questions qui distinguent l’expérience SP-API des simples tutoriels d’API
Ces questions appellent des réponses vérifiables. Chacune correspond à un comportement décrit dans la documentation d’Amazon : un candidat ayant une véritable expérience en production répondra donc rapidement et avec précision.
| Question | Réponse solide | Réponse insuffisante |
|---|---|---|
| Comment gérerez-vous la limitation ? | Il applique un back-off lors des réponses 429, sait que les limites s’appliquent à chaque paire application-vendeur, utilise les notifications plutôt que des boucles de polling et lit l’en-tête x-amzn-RateLimit-Limit lorsqu’il est présent, sans en dépendre | Des temporisations fixes ou l’idée de demander à Amazon des limites plus élevées |
| Comment testerez-vous les limites de débit avant le lancement ? | Il utilise la sandbox uniquement pour tester la gestion des réponses 429, puis vérifie les limites réelles en production | Il affirme que les tests sandbox sont concluants et que les limites sont donc correctes, alors que toutes les opérations sandbox partagent le même débit |
| Sur quelle version d’Orders API développerez-vous ? | v2026-01-01, en demandant uniquement les valeurs includedData nécessaires | v0, ou ne sait pas qu’il existe plusieurs versions |
| Comment les offres seront-elles créées et mises à jour ? | Avec Listings Items API ou des flux JSON, en s’appuyant sur les définitions de types de produits et en gérant les problèmes signalés | Avec des flux XML ou flat-file |
| De quels rôles avons-nous besoin et pourquoi ? | Uniquement des rôles nécessaires au cas d’usage, avec une explication claire de ceux qui donnent accès aux données personnelles | Demander tous les rôles par précaution |
| Où les identifiants seront-ils stockés et comment seront-ils renouvelés ? | Dans un gestionnaire de secrets, avec un plan de renouvellement et aucun secret dans le code, les tickets ou les conversations | Des identifiants envoyés par e-mail ou enregistrés dans un dépôt |
| Que surveillerez-vous après le lancement ? | Les appels en échec, les taux de limitation, les problèmes d’offres, les métriques d’utilisation des API dans l’Amazon Solution Provider Portal et le calendrier de retrait | Rien : tout fonctionnera simplement |
Un point mérite d’être souligné, car il surprend souvent. Pour les opérations soumises à des plans d’utilisation dynamiques, Amazon ajuste les limites de débit pour chaque selling partner selon des indicateurs commerciaux, et non selon le nombre de requêtes envoyées par l’application. Appeler plus souvent n’augmente pas la limite. La solution à une intégration limitée consiste à effectuer moins d’appels, mais mieux conçus, et non à faire pression sur Amazon.
Freelance, agence ou recrutement en interne ?
Le bon choix dépend moins des compétences que de la continuité, car une intégration SP-API doit être entretenue. Les dates de retrait du calendrier d’Amazon s’étendent sur trois années consécutives : une mission qui se termine dès la livraison peut donc vous laisser sans solution lors du prochain retrait.
| Votre situation | Option généralement la plus adaptée | Point de vigilance |
|---|---|---|
| Une marketplace, un ou deux flux de données et des besoins qui évoluent peu | Un freelance expérimenté | Un point de défaillance unique ; exigez l’accès au dépôt et un guide d’exploitation écrit |
| Plusieurs marketplaces ou flux de données, avec un besoin de continuité | Une petite agence ou un studio | Vérifiez que la personne qui réalise le développement assurera également la maintenance |
| Amazon est votre canal principal et vos besoins changent constamment | Un recrutement en interne ou un contrat de maintenance à long terme | Prévoyez la maintenance comme un poste budgétaire permanent |
Les clauses qui protègent votre intégration Amazon
- Le code dans votre dépôt. Le code source et les définitions d’infrastructure vous appartiennent et sont hébergés dans une organisation que vous contrôlez.
- L’enregistrement et les identifiants dans votre compte. Le profil développeur, l’enregistrement de l’application et les identifiants sont rattachés à votre entreprise, le développeur étant ajouté comme utilisateur.
- Une responsabilité clairement attribuée pour les retraits. Le contrat précise qui surveille le calendrier de retrait d’Amazon et qui effectue les migrations avant chaque échéance.
- Un guide d’exploitation. Il couvre la limitation, les flux ou offres en échec, les identifiants expirés et la procédure de nouvelle autorisation.
- Des clauses sur la gestion des données. Les données des acheteurs sont traitées conformément à la Data Protection Policy d’Amazon et seuls les rôles nécessaires au projet sont demandés.
- Une validation sur du trafic réel. Les paiements sont liés au passage de commandes ou d’offres réelles en production, et pas uniquement à des démonstrations dans la sandbox.
Obtenir un devis cadré pour votre intégration Amazon
Pour recevoir des devis comparables, transmettez les quatre mêmes informations à chaque candidat : les marketplaces Amazon sur lesquelles vous vendez, les flux de données que vous souhaitez automatiser, le système auquel les données doivent parvenir et la présence éventuelle de code existant reposant sur Orders v0 ou des flux XML. Ces quatre réponses déterminent l’essentiel du prix et du risque.
Si vous souhaitez que Netalith définisse le périmètre, utilisez le formulaire de devis gratuit de Netalith et sélectionnez le service d’intégration marketplace.
FAQ
Questions fréquentes
Dois-je m’enregistrer comme développeur pour utiliser Amazon SP-API avec ma propre boutique ?
Oui. Vous devez compléter un profil développeur dans l’Amazon Solution Provider Portal et enregistrer une application. Pour votre propre entreprise, vous vous enregistrez comme développeur privé, et l’utilisateur principal du compte doit terminer l’enregistrement. Amazon décide d’accorder ou non l’accès en fonction du profil, notamment de la fonctionnalité de l’application et de sa conformité avec l’Acceptable Use Policy et la Data Protection Policy.
Amazon facture-t-il l’accès à SP-API en 2026 ?
Pas à la date de septembre 2026. Amazon a annoncé des frais développeur en novembre 2025, puis a indiqué aux développeurs le 12 mai 2026 qu’il ne mettrait pas en œuvre les frais d’utilisation et l’abonnement annuel pour le moment. En raison de cette formulation, vérifiez à nouveau le site développeur d’Amazon avant de signer un contrat de longue durée.
Quelle est la différence entre un développeur SP-API privé et public ?
Un développeur privé crée des applications qui intègrent uniquement sa propre entreprise à Amazon, et ces applications sont autorisées automatiquement. Un développeur public crée des applications pour d’autres vendeurs. Elles sont soumises à des limites d’autorisation et, lorsqu’elles demandent des rôles restreints donnant accès à des données personnelles, à un examen de l’architecture par l’équipe SP-API Solutions Architecture d’Amazon.
Mon développeur peut-il utiliser mes identifiants Seller Central ?
À éviter. Seul l’utilisateur principal du compte peut terminer l’enregistrement développeur, mais Amazon propose une gestion des utilisateurs dans l’Amazon Solution Provider Portal. Le développeur doit donc utiliser son propre utilisateur plutôt qu’une connexion principale partagée. Vous pourrez ainsi également révoquer son accès à la fin de la mission.
SP-API est-elle la même chose que l’Amazon Ads API ?
Non. SP-API couvre les données des selling partners, comme les offres, les commandes, les stocks, les rapports et les finances. Les campagnes publicitaires sont gérées par l’API publicitaire distincte d’Amazon, qui possède son propre processus d’enregistrement. Vérifiez donc laquelle de ces API votre projet nécessite avant de présenter votre besoin à un développeur.
Quelles sont les trois questions les plus rapides pour évaluer un développeur SP-API ?
Demandez-lui sur quelle version d’Orders API il développera — la bonne réponse est v2026-01-01, et non v0 —, comment il gérera les réponses 429 liées à la limitation — back-off et notifications, pas des temporisations fixes — et comment les offres seront créées — Listings Items API ou flux JSON, et non des flux XML qu’Amazon a retirés.