Autorizzazione delle applicazioni API per i partner di vendita
Scopri come autorizzare le app SP-API.
Il modello di autorizzazione per l'API Selling Partner si basa su Accedi con Amazon, l'implementazione di OAuth 2.0 da parte di Amazon. In questo modello, la tua applicazione è autorizzata tramite interazioni con le pagine visualizzate da Amazon e dal tuo sito web. Il browser Web è l'agente utente che trasmette i parametri tra il tuo sito Web e Amazon ad ogni azione del partner di vendita. Per implementare l'autorizzazione OAuth devi configurare il tuo sito web per:
- Accetta ed elabora i parametri che Amazon gli trasmette
- Reindirizza il browser web e passa i parametri ad Amazon
Come viene autorizzata la mia applicazione?
-
Applicazioni pubbliche per venditori: applicazioni disponibili al pubblico e autorizzate dai venditori. Queste applicazioni possono essere autorizzate utilizzando i seguenti metodi:
- Flusso di lavoro di autorizzazione dell'appstore del partner di vendita: un flusso di lavoro di autorizzazione OAuth avviato dalla pagina dei dettagli dell'Appstore per i partner di vendita.
- Flusso di lavoro di autorizzazione del sito Web: un flusso di lavoro di autorizzazione OAuth avviato dal tuo sito Web.
-
Applicazioni pubbliche per i fornitori: applicazioni disponibili al pubblico e autorizzate dai fornitori. Queste applicazioni possono essere autorizzate utilizzando il seguente metodo:
- Flusso di lavoro di autorizzazione del sito Web: un flusso di lavoro di autorizzazione OAuth avviato dal tuo sito Web.
-
Applicazioni private per venditori o fornitori: applicazioni disponibili solo per la tua organizzazione. Possono essere applicazioni per venditori o fornitori. Queste applicazioni possono essere autorizzate utilizzando il seguente metodo:
Nota
Puoi chiamare operazioni senza concessione senza l'autorizzazione esplicita di un partner di vendita.
Crea un URI di autorizzazione OAuth
Un URI di autorizzazione OAuth è un componente chiave per creare e testare i flussi di lavoro di autorizzazione dell'API per i partner di vendita. L'URI di autorizzazione OAuth reindirizza un browser a una pagina di consenso di Amazon, in cui tu o un partner di vendita potete dare alla tua applicazione il consenso per effettuare chiamate all'API per i partner di vendita.
Se un partner di vendita autorizza la tua applicazione a partire dal sito Web utilizzando il flusso di lavoro di autorizzazione del sito Web, il tuo sito Web utilizza un URI di autorizzazione OAuth per reindirizzare il partner di vendita alla pagina di consenso di Amazon. Anche se un partner di vendita autorizza la tua applicazione a partire dall'Appstore per i partner di vendita, il flusso di lavoro di autorizzazione dell'Appstore per i partner di vendita, hai ancora bisogno di un URI di autorizzazione OAuth per testare il flusso di lavoro di autorizzazione in stato di bozza prima di creare un'offerta attiva nell'Appstore per i partner di vendita.
Quando si crea un URI di autorizzazione OAuth, le applicazioni vengono raggruppate in due tipi:
-
Tutte le applicazioni pubbliche e le applicazioni per venditori privati. Questa categoria include:
- Applicazioni disponibili al pubblico e autorizzate da un venditore o fornitore
- Applicazioni per venditori autorizzate disponibili solo per la tua organizzazione
-
Applicazioni di fornitori privati. Applicazioni di fornitori autorizzate disponibili solo per la tua organizzazione.
Le procedure seguenti spiegano come creare un URI di autorizzazione OAuth, a seconda del tipo di applicazione.
Nota
Puoi trovare l'ID dell'applicazione dopo il nome dell'applicazione nella console per sviluppatori.
Crea un URI di autorizzazione OAuth per le applicazioni per fornitori pubblici
-
Ottieni l'URL di Seller Central per il marketplace in cui desideri che i partner di vendita autorizzino la tua applicazione. Fai riferimento a URL di Seller Central per un elenco di URL per marketplace. Esempio:
https://sellercentral.amazon.com
-
Combina l'URL di Seller Central con
/apps/authorize/consent?application_id={your application ID}
. Ad esempio:https://sellercentral.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
Crea un URI di autorizzazione OAuth per le applicazioni per fornitori pubblici
-
Ottieni l'URL di Vendor Central del marketplace in cui desideri che i partner di vendita autorizzino la tua candidatura. Fai riferimento a URL di Vendor Central per un elenco di URL per marketplace. Ad esempio:
https://vendorcentral.amazon.com
-
Combina l'URL di Vendor Central con
/apps/authorize/consent?{your application ID}
. Ad esempio:https://vendorcentral.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
È necessario creare gli URI di autorizzazione OAuth per i marketplace in cui i partner di vendita autorizzeranno la domanda. Ad esempio, se un venditore dispone di un account Seller Central per il Messico, avrà bisogno di un URI di autorizzazione OAuth per il Messico per avviare l'autorizzazione della tua richiesta (https://sellercentral.amazon.com.mx/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28
). Le autorizzazioni sono regionali. Una volta completata l'autorizzazione, la tua richiesta avrà accesso all'account del venditore in qualsiasi marketplace della regione del Nord America. Gli stessi concetti si applicano ai fornitori che utilizzano Vendor Central. È possibile utilizzare il API GetMarketplace Participations per scoprire i marketplace attivi per un partner di vendita.
Se crei un URI di autorizzazione OAuth per testare il flusso di lavoro di autorizzazione, aggiungi version=beta
etichetta. Ciò indica che il flusso di lavoro di autorizzazione è per un'applicazione in stato di bozza. Ad esempio: https://sellercentral-europe.amazon.com/apps/authorize/consent?application_id=amzn1.sellerapps.app.0bf296b5-36a6-4942-a13e-EXAMPLEfcd28&version=beta
Per informazioni sulla creazione e il test di un flusso di lavoro di autorizzazione, fai riferimento a Flusso di lavoro di autorizzazione dell'Appstore per i partner di vendita e Flusso di lavoro di autorizzazione del sito Web.
Updated 28 days ago