Hub per sviluppatoriStato dell'APISupporto

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

  1. Installare Java 8 o versioni successive, Apache Maven 3.6. o superiore, e GNU Wget e rendili disponibili nel tuo $PATH.

  2. Vai al repository modelli API per partner di vendita su GitHub.

  3. Clona il repository per crearne una copia locale sul tuo computer, se non l'hai già fatto.

  4. Apri una finestra del prompt dei comandi e vai alla directory in cui desideri scaricare Swagger Code Generator.

  5. 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.jar

    swagger-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

  6. Copia swagger-codegen-cli.jar in una struttura di directory che abbia senso per te. Per questo esempio, lo copieremo in C:\SwaggerToCL.

  7. Naviga verso sellers.json nel selling-partner-api-models\models\sellers-api-model cartella della tua copia locale del repository.

  8. sellers.json + C:\SwaggerToCL.

  9. 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.json

    L'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.

  10. 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 esegui mvn package. Questo genera una cartella denominata "target". In questa cartella è presente un file JAR denominato sellingpartnerapi-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, artifactIde i valori della versione nella parte superiore di pom.xml file nel selling-partner-api-models\clients\sellingpartner-api-aa-java cartella.

  11. 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 oggetto ApiResponse<OperationNameResponse> che contiene l'intestazione e il codice di stato oltre al payload di OperationName.

Esempio: Il metodo getMarketplaceParticipations restituirà un oggetto di tipo GetMarketplaceParticipationsResponse, mentre l'operazione getMarketplaceParticipationsWithHttpInfo restituirà un oggetto di tipo ApiResponse<GetMarketplaceParticipationsResponse>. L'oggetto ApiResponse<GetMarketplaceParticipationsResponse> contiene l'intestazione e il codice di stato, nonché un oggetto GetMarketplaceParticipationsResponse.


Questa pagina ti è stata utile?