Intégrer le partenaire de vente Amazon API

Pour accéder aux données via le partenaire de vente Amazon API (SP-API), vous devez effectuer les actions suivantes :

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

2. Demander des API rôles SP-

3. Enregistrez votre candidature

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

5. Connect au SP- API

Inscrivez-vous en tant que API développeur SP

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

Demander des API rôles SP-

Un APIrôle SP 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 API documentation SP-.

Enregistrement du dossier

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 API documentation SP-.

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

Le modèle d'autorisation pour le partenaire vendeur API 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 API applications des partenaires vendeurs dans la API documentation SP-.

Comprendre les autorisations 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 modes de traitement des autorisations suivants :

  • Flux de travail d'autorisation de l'Appstore du partenaire vendeur : un flux de travail OAuth d'autorisation lancé à partir de la page détaillée de l'Appstore du partenaire vendeur.

  • Flux de travail d'autorisation du site Web — Un flux de travail OAuth d'autorisation lancé à partir de votre propre site Web.

• 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é depuis 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 SP-. API

Autoriser les groupes de fournisseurs à accéder aux applications

Lorsque vous autorisez votre API application 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 API l'intégration 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 API documentation SP-.

Connect au SP- API

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