Genera un Java SDK
Genera un SDK Java con scambio di token LWA
Queste istruzioni spiegano come generare un Java SDK per l'API Sellers utilizzando Generatore di codice Swagger su un computer che esegue Microsoft Windows. Il processo è lo stesso per gli utenti di altri sistemi operativi come macOS o Linux, con la sostituzione della semantica specifica di Windows (ad esempio, C:\
). Sebbene queste istruzioni si riferiscano all'API Sellers, puoi modificare le istruzioni per generare SDK per qualsiasi altra API di Selling Partner. Fai riferimento al Pagina dei modelli per i modelli Swagger per ogni sezione dell'API Selling Partner.
Con questo SDK puoi effettuare richieste all'API Selling Partner con il seguente codice, che è già impostato per te: Accedi con Amazon (LWA) token exchange (scambia un token di aggiornamento con un token di accesso).
Genera un SDK Java con scambio di token LWA
-
Installare Java 8 o versioni successive, Apache Maven 3.6. o superiore, e GNU Wget e rendili disponibili nel tuo
$PATH
. -
Vai al repository modelli API per partner di vendita su GitHub.
-
Clona il repository per crearne una copia locale sul tuo computer, se non l'hai già fatto.
-
Apri una finestra del prompt dei comandi e vai alla directory in cui desideri scaricare Swagger Code Generator.
-
Scarica l'ultima versione di Swagger Code Generator.
Ad esempio:
wget https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.13/swagger-codegen-cli-2.4.13.jar -O swagger-codegen-cli.jarswagger-codegen-cli.jar
downloads to the current directory.Nota
È inoltre possibile effettuare il download da maven.org indirizzando il browser a https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.13/swagger-codegen-cli-2.4.13.jar
-
Copia
swagger-codegen-cli.jar
in una struttura di directory che abbia senso per te. Per questo esempio, lo copieremo inC:\SwaggerToCL
. -
Naviga verso
sellers.json
nelselling-partner-api-models\models\sellers-api-model
cartella della tua copia locale del repository. -
sellers.json
+C:\SwaggerToCL
. -
Genera l'SDK in base ai modelli in
selling-partner-api-models\clients\sellingpartner-api-aa-java
cartella della tua copia locale del repository. Questa cartella contiene una libreria di autorizzazione e autenticazione, insieme a modelli personalizzati per Swagger Code Generator e un file di configurazione per generare la versione corretta dell'SDK.Ad esempio:
java -jar C:\SwaggerToCL\swagger-codegen-cli.jar generate \ -i C:\SwaggerToCL\Sellers.json \ -l java \ -t [path to selling-partner-api-models\clients\sellingpartner-api-aa-java folder]\resources\swagger-codegen\templates\ \ -o C:\SwaggerToCL\Sellers_JavaCL \ -c [path to selling-partner-api-models\clients\sellingpartner-api-aa-java folder]\resources\java\config.jsonL'SDK viene copiato in
C:\SwaggerToCL\Sellers_JavaCL
Notazione della versione:
Nei passaggi seguenti,
x.x
si riferisce all'ultima versione della libreria AA. Fare riferimento al leggimi per l'ultima versione. -
Crea la libreria AA e aggiungila come dipendenza dell'SDK:
-
Naviga fino alla cartella
selling-partner-api-models\clients\sellingpartner-api-aa-java
della tua copia locale del repository ed eseguimvn package
. Questo genera una cartella denominata "target". In questa cartella è presente un file JAR denominatosellingpartnerapi-aa-java-x.x-jar-with-dependencies.jar
(o simile) e tutte le dipendenze richieste. -
Installa il file JAR nel tuo repository Maven locale.
Ad esempio:
mvn install:install-file -Dfile=[path to JAR file in "target" folder] -DgroupId=com.amazon.sellingpartnerapi -DartifactId=sellingpartnerapi-aa-java -Dversion=x.x -Dpackaging=jar
Puoi trovare l'effettivo
groupId
,artifactId
e i valori della versione nella parte superiore dipom.xml
file nelselling-partner-api-models\clients\sellingpartner-api-aa-java
cartella. -
-
Aggiungi una dipendenza dalla libreria AA nel
pom.xml
della libreria client:Ad esempio:
<dependency> <groupId>com.amazon.sellingpartnerapi</groupId> <artifactId>sellingpartnerapi-aa-java</artifactId> <version>x.x</version> </dependency>
Dopo aver generato il tuo SDK, puoi utilizzarlo per effettuare chiamate all'API per i partner di vendita. Vedi Connessione all'API per i partner di vendita utilizzando un Java SDK generato.
Registrazione delle intestazioni di richiesta e risposta
Per ottenere le intestazioni di richiesta e risposta utilizzando il tuo SDK, aggiungi
WithHttpInfo
al nome del metodo. Questa nuova operazione restituisce un oggettoApiResponse<OperationNameResponse>
che contiene l'intestazione e il codice di stato oltre al payload diOperationName
.Esempio: Il metodo
getMarketplaceParticipations
restituirà un oggetto di tipoGetMarketplaceParticipationsResponse
, mentre l'operazionegetMarketplaceParticipationsWithHttpInfo
restituirà un oggetto di tipoApiResponse<GetMarketplaceParticipationsResponse>
. L'oggettoApiResponse<GetMarketplaceParticipationsResponse>
contiene l'intestazione e il codice di stato, nonché un oggettoGetMarketplaceParticipationsResponse
.
Updated 23 days ago