Welcome to the Tradenity Java SDK
To use the Tradenity SDK, you must have:
- Working Java development environment (currently JDK 1.7 is the only tested version, but Java 6 and 8 should work).
- Active account in Tradenity
The SDK is available through maven central, You can install it using any compatible tool.
<dependency> <groupId>com.tradenity</groupId> <artifactId>java-sdk</artifactId> <version>1.0.2</version> </dependency>
Add this line to the
<dependency org="com.tradenity" name="java-sdk" rev="1.0.2"/>
Setup your credentials
First of all, you have to get API keys for your store, you can find it in your store
To get there navigate to the stores list page, click on the
Edit button next to your store name, scroll down till you find the
API Keys section.
Initialize the library
With the API key in hand, you can initialize the Tradenity client.
Tradenity client needs the API key and an instance of
which is an object that makes Tradenity session integrates with the web framework's session mechanism.
The Java SDK provide the interface and a default implementation suitable for single user application (such as android app),
and it's easy to implement your own for other frameworks, It is a simple 3 method interface.
If you are using Spring framework or Grails, the Spring SDK extension provide implementation suitable for Spring and Grails.
TradenityClient client = new TradenityClient('sk_1234567')
Make sure to replace the api keys with the ones for your store, otherwise you will get authentication error
Make your First call
The Tradenity SDK is organized into a group of model entitiy classes that corresponds to the REST API's resources, each encapsulate the operation for a specific entity model,
for example to perform operations related to the
Brand resource you can use the corresponding
Now, just call any method in your code.
BrandService brandService = new BrandService(client); Brand brand = brandService.findById("1243-9786786-jhgjtu-789s6i");
Tutorials and sample applications
We provide 2 sample applications, actually it is the same application implemented using 2 frameworks:
Spring MVC, and
Live demo of Camerastore, check it out to have an idea of what Tradenity API can do.
You can find the code at Github:
We also provide a detailed explanation of the code of these sample applications in the form of a step by step tutorials: