JarCastingNewegg SDK for Java
Newegg Marketplace SDK(Java) is a library to help Java programmer easily integrates with Newegg Marketplace API. It provides the definition of the data objects models to help coder create the request and resolve the response. It also provides customize of logger and retry mechanism. To use the SDK to communicate with the Newegg API, you need to be a registered seller and get the 'API Key(Authorization)' and 'Secret Key' by mail [email protected]. You can put this information into a 'newegg.properties' file. Without the Authorization Token and Secret Key, you can run the test project with Simulation Mode. This mode is to help you understand the SDK before actual use.
Technology
- java 1.8+
- openfeign
- log4j2
- commons-configuration2
build
- mvn package
How to use it in your project
Maven
- Set pom.xml of project
<parent>
<groupId>com.newegg.marketplace</groupId>
<artifactId>sdk-all</artifactId>
<version>{version}</version>
</parent>
and other that you used
Project
- Write your property (newegg.properties)
newegg.simulation=false
newegg.platform=USA
newegg.hosturl=https://api.newegg.com/marketplace
newegg.sellerid=XXX
newegg.authorization=XXXXXXXXXXXX
newegg.secretkey=XXXX-XXXXX-XXXX-XXXX-XXXX
newegg.retry.period=100
newegg.retry.maxperiod=1000
newegg.retry.maxattempts=2
newegg.loglevel=NONE
newegg.connectTimeoutMillis=10000
newegg.readTimeoutMillis=60000
newegg.item.simulation=false
newegg.item.retry.period=100
newegg.item.retry.maxperiod=1000
newegg.item.retry.maxattempts=2
newegg.item.loglevel=FULL
- loglevel
NONE: No logging
BASIC: Log only the request method and URL and the response status code and execution time
HEADERS: Log the basic information along with request and response headers
FULL: Log the headers, body, and metadata for both requests and responses
- Write your code
APIConfig.load(ItemConfig.class);
ItemCall call=new ItemCall();
GetVolumeDiscountRequest request=new GetVolumeDiscountRequest();
GetVolumeDiscountRequest.RequestBody body=new GetVolumeDiscountRequest.RequestBody();
body.setNeweggItemNumber("XXXXXXXXXXXXXX");
request.setRequestBody(body);
GetVolumeDiscountResponse r=call.getVolumeDiscountRequestResult(request);
Do something
How to get the API key and Secret Key?
1. Send the request to [email protected] from the seller default email address.
2. The message should include seller name or default email address.
Newegg Marketplace team will process all requests in 24 hours.
Note
- There is a file "newegg.properties" at same directory.
- The jar of common module must be have.
- The properties of common module must be set up.
- If the APP not load the configuration ,the simulation will be enabled
How to load configuration ?
APIConfig.load(SellerConfig.class);
- Log4j configuration file location
By default, Log4j looks for a configuration file named log4j2.xml (not log4j.xml) in the classpath.
You can also specify the full path of the configuration file with this system property: -Dlog4j.configurationFile=path/to/log4j2.xml
Web applications can specify the Log4j configuration file location with a servlet context parameter.
Modules
common
- used for other modules
Item
Seller
- Seller Management
https://developer.newegg.com/newegg_marketplace_api/seller_management/
Order
Shipping
- Newegg Shipping Label Service
https://developer.newegg.com/newegg_marketplace_api/newegg_shipping_label_service/
Other
- Verify Service Status
https://developer.newegg.com/newegg_marketplace_api/verify_service_status/
SBN
- Shipped by Newegg Management
https://developer.newegg.com/newegg_marketplace_api/sbn_shipped_by_newegg_management/
DataFeed
- DataFeed Management
https://developer.newegg.com/newegg_marketplace_api/datafeed_management/
Report
- Reports Management
https://developer.newegg.com/newegg_marketplace_api/reports_management/
RMA
- RMA(Return Merchandise Authorization) Management
https://developer.newegg.com/newegg_marketplace_api/rma_management/
