Generación de un SDK de Java con autenticación e intercambio de tokens LWA

Nota para los desarrollador de C#. También proporcionamos una biblioteca para generar un SDK de C# con autenticación e intercambio de tokens LWA. Para obtener más información, consulte README.md en https://github.com/amzn/selling-partner-api-models/tree/main/clients/sellingpartner-api-aa-csharp .

Estas instrucciones le muestran cómo generar un SDK de Java para la API de sellers utilizando el Swagger Code Generator en una computadora con Microsoft Windows. El proceso es el mismo para los usuarios de otros sistemas operativos como macOS o Linux, con el reemplazo de la semántica específica de Windows (por ejemplo, C:). Aunque estas instrucciones son para la API de sellers, puede modificar las instrucciones para generar SDK para cualquier otra Sellers API. Consulte la SP-API models para conocer los modelos de Swagger para cada sección de la Selling Partner API.

Con este SDK puede realizar solicitudes a la Selling Partner API con el siguiente código ya configurado para usted: Iniciar sesión con el intercambio de tokens de Amazon (intercambiar un token de actualización por un token de acceso) y autenticación.

Para generar un SDK de Java con autenticación e intercambio de tokens LWA

1. Instale Java 8 o posterior , Apache Maven 3.6. o superior, y GNU Wget y hacer que estén disponibles en su $PATH .
2. Vaya al selling-partner-api-models en GitHub.
3. Clone el repositorio para hacer una copia local en su computadora, si aún no lo ha hecho.
4. Abra una ventana del símbolo del sistema y vaya a un directorio donde desee descargar el Generador de código Swagger.
5. Descargar la última versión del Generador de código Swagger.

Por ejemplo:

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 Descargar en el directorio actual.

Nota: También puede Descargar desde maven.org dirigiendo su navegador aquí: https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.13/swagger-codegen-cli-2.4.13.jar

6. Copie swagger-codegen-cli.jar en una estructura de directorios que tenga sentido para usted. Para este ejemplo, lo copiaremos en C:\SwaggerToCL.
7. Navegue a sellers.json en la selling-partner-api-models\models\sellers-api-model de su copia local del repositorio.
8. Copie sellers.json en C:\SwaggerToCL.
9. Genere el SDK con las plantillas en la selling-partner-api-models\clients\sellingpartner-api-aa-javade su copia local del repositorio. Esta carpeta contiene una biblioteca de autorización y autenticación, junto con plantillas personalizadas para Swagger Code Generator.

Por ejemplo:

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

El SDK se copia en C:\SwaggerToCL\Sellers_JavaCL

10. Cree la biblioteca AA y agréguela como una dependencia del SDK:
    1. Navegue a la selling-partner-api-models\clients\sellingpartner-api-aa-java de su copia local del repositorio y ejecute mvn package . Esto genera un folder llamada "target". En esta folder hay un archivo JAR llamado sellingpartnerapi-aa-java-1.0-jar-with-dependencies.jar (o algo similar) y todas las dependencias requeridas.
    2. Instale el archivo JAR en su repositorio Maven local.

Por ejemplo:

mvn install:install-file -Dfile=[path to JAR file in "target" folder] -DgroupId=com.amazon.sellingpartnerapi -DartifactId=sellingpartnerapi-aa-java -Dversion=1.0 -Dpackaging=jar

Puede encontrar los valores reales de groupId, artifactId, y versión cerca de la parte superior del archivo pom.xml en la selling-partner-api-models\clients\sellingpartner-api-aa-java .

11. Agregue una dependencia en la biblioteca AA en el pom.xml de la biblioteca del cliente:

Por ejemplo:

<dependency>
  <groupId>com.amazon.sellingpartnerapi</groupId>
  <artifactId>sellingpartnerapi-aa-java</artifactId>
  <version>1.0</version>
</dependency>

Una vez que haya generado su SDK, puede usarlo para realizar llamadas a la Selling Partner API. Consulte Conexión a la API de Selling Partner mediante un SDK de Java generado .

📘

Logging request y response headers

Para obtener headers de request y response con su SDK, agregue WithHttpInfo al nombre del método. Esta nueva operación devuelve un objeto ApiResponse<OperationNameResponse> , que contiene el header y el status code además de la carga útil del OperationName .

Ejemplo: El método getMarketplaceParticipations devolverá un objeto de tipo GetMarketplaceParticipationsResponse , mientras que la operación getMarketplaceParticipationsWithHttpInfo devolverá un objeto de tipo ApiResponse<GetMarketplaceParticipationsResponse> . El ApiResponse<GetMarketplaceParticipationsResponse> El objeto contiene el header y el status code, así como un Objeto GetMarketplaceParticipationsResponse .