View a markdown version of this page

Intégration de l'API Amazon Selling Partner - AWS Conseils prescriptifs
Inscrivez-vous en tant que développeur SP-APIDemander des rôles SP-APIEnregistrez votre candidatureSélectionnez un modèle d'autorisationConnectez-vous à l'API SP-API

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégration de l'API Amazon Selling Partner

Pour accéder aux données via l'API Amazon Selling Partner (SP-API), vous devez effectuer les actions suivantes :

  1. Inscrivez-vous en tant que développeur SP-API

  2. Demander des rôles SP-API

  3. Enregistrez votre candidature

  4. Sélectionnez un modèle d'autorisation pour votre application

  5. Connectez-vous à l'API SP-API

Inscrivez-vous en tant que développeur SP-API

Avant de pouvoir enregistrer votre application SP-API, vous devez créer un compte de développeur Amazon et vous enregistrer en tant que développeur SP-API. Pour un aperçu complet du processus d'enregistrement des développeurs, consultez la section Présentation de l'enregistrement SP-API dans la documentation SP-API.

Demander des rôles SP-API

Un rôle SP-API détermine si un développeur ou une application a accès à une opération ou à une ressource spécifique. En tant que développeur, vous devez demander et vous qualifier pour un rôle particulier, sinon vous ne pourrez pas accéder aux opérations et aux ressources regroupées sous ce rôle.

Les rôles protègent l'accès aux informations personnelles identifiables (PII) et à d'autres données sensibles. Ils limitent l'accès aux données pour garantir que les développeurs ne peuvent accéder qu'aux données nécessaires à leur application. Cela permet de protéger les données des clients et de préserver leur confiance.

Pour accéder aux données disponibles dans les rapports d'analyse de marque, vous devez disposer du rôle Brand Analytics. Pour plus d'informations sur la demande d'accès à un rôle, consultez la section Comment demander un rôle et me qualifier pour un rôle dans la documentation de l'API SP-API.

Enregistrez votre candidature

Le processus d'inscription varie légèrement en fonction du type de demande. Aux fins de l'enregistrement, les demandes sont classées dans l'un des types suivants :

  • Applications publiques et applications pour vendeurs privés : il s'agit d'applications accessibles au public et autorisées par un vendeur ou d'un fournisseur, ou d'applications de vendeur qui ne sont disponibles que pour votre organisation et qui sont auto-autorisées.

  • Applications de fournisseurs privés : il s'agit d'applications de fournisseurs qui ne sont disponibles que pour votre organisation et qui sont auto-autorisées.

Pour plus d'informations, consultez la section Enregistrer votre application dans la documentation SP-API.

Sélectionnez un modèle d'autorisation pour votre application

Le modèle d'autorisation pour l'API Selling Partner est basé sur Login with Amazon, une implémentation Amazon de la OAuth version 2.0. Votre application est autorisée par le biais d'interactions avec les pages affichées par Amazon et votre site Web. Le navigateur Web est l'agent utilisateur qui transmet les paramètres entre votre site Web et Amazon à chaque action du partenaire commercial. Pour implémenter OAuth l'autorisation, vous devez configurer votre site Web pour accepter et traiter les paramètres qu'Amazon lui transmet. Vous devez également configurer votre site Web pour rediriger le navigateur Web et transmettre les paramètres à Amazon. Pour plus d'informations sur l'autorisation, consultez la section Autorisation des applications API Selling Partner dans la documentation de l'API SP-API.

Comprendre l'autorisation des applications

Aux fins de l'autorisation, il existe trois types de demandes :

  • Applications publiques pour les vendeurs : ces applications sont accessibles au public et sont autorisées par les vendeurs. Vous pouvez choisir l'un des flux de travail d'autorisation suivants :

  • Applications publiques pour les fournisseurs : ces applications sont accessibles au public et sont autorisées par les fournisseurs. Vous pouvez utiliser le flux de travail d'autorisation du site Web. Il s'agit d'un flux de travail OAuth d'autorisation lancé à partir de votre propre site Web.

  • Applications privées pour les vendeurs ou les fournisseurs : ces applications ne sont disponibles que pour votre organisation. Il peut s'agir de demandes de vendeurs ou de fournisseurs. Vous pouvez utiliser l'approche d'auto-autorisation. Lorsque vous créez une application privée pour votre propre organisation, vous pouvez l'autoriser automatiquement à accéder aux informations de votre compte. Vous pouvez autoriser vous-même votre candidature à l'état de brouillon ; il n'y a aucune raison de publier une candidature privée. Pour plus d'informations sur la révocation de l'auto-autorisation dans les applications du vendeur et du fournisseur, consultez la section Révoquer les auto-autorisations dans la documentation de l'API SP-API.

Autoriser les groupes de fournisseurs à accéder aux applications

Lorsque vous autorisez votre application API Selling Partner à accéder à vos données, vous accordez l'accès au groupe de fournisseurs associé aux informations de connexion de votre compte Vendor Central. Par extension, vous accordez l'accès à tous les codes fournisseurs présents dans le groupe de fournisseurs. Il est donc important d'utiliser les informations d'identification Vendor Central et le bon groupe de fournisseurs pour l'intégration de l'API de votre partenaire de vente.

Le groupe de fournisseurs est le compte auquel vous vous connectez. En fonction de vos contrats commerciaux, de vos modèles opérationnels et d'autres facteurs, votre groupe de fournisseurs peut inclure un ou plusieurs codes fournisseur. Chaque code fournisseur vous permet de répertorier des produits dans une catégorie spécifique ou inclut les accords commerciaux nécessaires, tels qu'un code fournisseur pour une marque en particulier.

Vous pouvez disposer de plusieurs autorisations pour chaque groupe de fournisseurs, ou vous pouvez créer un seul groupe de fournisseurs contenant tous vos codes fournisseur. La possibilité d'utiliser plusieurs groupes de fournisseurs associés à votre profil vous permet d'utiliser une application avec le même code fournisseur dans différents groupes de fournisseurs. Avec cette option, vous n'avez pas à soumettre plusieurs candidatures de développeur pour chaque groupe de fournisseurs.

Pour plus d'informations, consultez la section Autoriser les groupes de fournisseurs pour l'accès aux applications dans la documentation SP-API.

Connectez-vous à l'API SP-API

Après avoir enregistré et autorisé votre demande, vous pouvez commencer à faire des demandes. Pour plus d'informations, consultez la section Connexion à l'API Selling Partner dans la documentation de l'API SP-API.