Prerequisites
To use the Tradenity SDK, you must have:
- Working PHP development environment (currently PHP >= 5.3 is supported).
- Active account in Tradenity
Installation
You can install the PHP SDK using the standard composer tool.
composer install tradenity/php-sdk
Now install your framework specific extension library:
composer install tradenity/laravel-ext
composer install tradenity/symfony-ext
Setup your credentials
First of all, you have to get API keys for your store, you can find it in your store Edit page.
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 AuthTokenHolder which is an object that makes Tradenity session integrates with the web framework’s session mechanism. The SDK provide implementation for Flask and Django. It’s easy to implement your own for other frameworks, It is a simple 3 method interface.
<?php
require 'tradenity'
// Initialise the library with your store api key and your framework 's SessionIdAccessor:
TradenityClient::$key = 'sk_1234567';
//Add the framework dependent `SessionIdAccessor` (check documentation for details):
TradenityClient::$sessionIdAccessor = .... ;
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 Tradenity\SDK\Entities\Brand class.
Now, just call any method in your code.
<?php
$brand = Brand::findById("1243-9786786-jhgjtu-789s6i");
Tutorials and sample applications
We provide 2 sample applications, actually it is the same application implemented using 2 frameworks: Laravel, and Symfony.
Camera store sample application live demo
You can find the code at Github:
Camera store for laravel code.
Camera store for symfony code.
We also provide a detailed explanation of the code of these sample applications in the form of a step by step tutorials: