youailu1/codeswholesale-sdk

A PHP wrapper for CodesWholesale's API

Friday, June 15, 2018
by youailu1
Repository
1 Watchers
1 Stars
7 Installations

PHP
0 Dependents
0 Suggesters
0 Forks
0 Open issues
24 Versions
0 % Grown

The README.md

CodesWholesale PHP SDK

CodesWholesale.com is an API-driven wholesale platform for digital game distribution. This is the CodesWholesale SDK for PHP that will enable developers to easily integrate API with any PHP-based application., _(*1)

Installation

You can install codeswholesale-sdk-php via Composer or by downloading the source., _(*2)

Via Composer:

codeswholesale-sdk-php is available on Packagist as the codeswholesale/sdk package., _(*3)

Install Composer on your project root, _(*4)

curl -sS https://getcomposer.org/installer | php

Or download it from official page: https://getcomposer.org/download/, _(*5)

Configure the codeswholesale/sdk dependency in your 'composer.json' file:, _(*6)

"require": {
    "codeswholesale/sdk": "2.1"
}

Install the latest SDK with its dependencies on your project root, _(*7)

php composer.phar install

Create your CodesWholesale account

If you don’t have an account yet, sign up at CodesWholesale and set up your API credentials:, _(*8)

Create a CodesWholesale account and create your API keys in WEB API tab, under your profile name link. Save your keys in safe place. Your API password is visible only once.

Getting Started

Require the CodesWholesale PHP SDK via the composer auto loader, _(*9)
```
require 'vendor/autoload.php';
```

Configure the client using the API keys, _(*10)


$params = [
   /**
    * API Keys
    * These are test api keys that can be used for testing your integration:
    */
    'cw.client_id' => 'ff72ce315d1259e822f47d87d02d261e',
    'cw.client_secret' => '$2a$10$E2jVWDADFA5gh6zlRVcrlOOX01Q/HJoT6hXuDMJxek.YEo.lkO2T6',
    /**
     * CodesWholesale ENDPOINT
     */
    'cw.endpoint_uri' => \CodesWholesale\CodesWholesale::SANDBOX_ENDPOINT,
    /**
     * Due to security reasons, you should use SessionStorage only while testing.
     * In order to go live, you should change it to database storage.
    */
    'cw.token_storage' => new \CodesWholesale\Storage\TokenSessionStorage()
];


$clientBuilder = new \CodesWholesale\ClientBuilder($params);
$client = $clientBuilder->build();

For production release, please remember to switch from SANDBOX endpoint to LIVE endpoint., _(*11)

List all available platforms, regions, languages on the CodesWholesale platform, _(*12)

$platforms = $client->getPlatforms()
$regions   = $client->getRegions();
$languages = $client->getLanguages();

List all products from the price list, _(*13)

$products = $client->getProducts();
foreach($products as $product) {
    $product->getName(); // the name of product
    $product->getStockQuantity(); // current stock quantity
    $product->getImageUrl(ImageType::SMALL) // product image url
}

List all products from price list by language/platform/region, _(*14)

 $products = $client->getProducts([
       "language" => [
           "Multilanguage",
           "fr"
        ],
        "platform" => [
            "Steam"
        ],
        "region" => [
            "WORLDWIDE"
        ]
    ]);

foreach($products as $product) {
    $product->getName(); // the name of product
    $product->getStockQuantity(); // current stock quantity
    $product->getImageUrl(ImageType::SMALL) // product image url
}

List all products from price list from the last 60 days, _(*15)

$products = $client->getProducts([
    "inStockDaysAgo" => 60
]);

foreach($products as $product) {
    $product->getName(); // the name of product
    $product->getStockQuantity(); // current stock quantity
    $product->getImageUrl(ImageType::SMALL) // product image url
}

Fetch invoice for your order, _(*16)

$orderInvoice = Invoice::get($createdOrder->getOrderId());
$invoicePath = Base64Writer::writeInvoice($orderInvoice, "./invoices");

Screen your customer before completing order, _(*17)

$securityInformation = Security::check(
    "devteam@codeswholesale.com",
    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_4) AppleWebKit/600.7.12 (KHTML, like Gecko) Version/8.0.7 Safari/600.7.12",
    "devteam-payment@codeswholesale.com",
    "81.90.190.200"
);

$ipBlacklisted = $security->isIpBlacklisted();
$torIp = $security->isTorIp();
$domainBlackListed = $security->isDomainBlacklisted();
$subdomain = $security->isSubDomain();

Check your order history, _(*18)

$orders = Order::getHistory("2017-12-11", "2017-12-12");

foreach ($orderList as $order) { 
    $order->getOrderId();
    $order->getClientOrderId();
    $order->getTotalPrice() ;
    $order->getStatus();
    $order->getCreatedOn();
}

Single product details, _(*19)

$product = \CodesWholesale\Resource\Product::get($productHref);

Retrieve product description, _(*20)

$productDescription = \CodesWholesale\Resource\ProductDescription::get($product->getDescriptionHref());

$productDescription->getLocalizedTitles(); // localized titles
$productDescription->getPegiRating(); // pegi rating
$productDescription->getPlatform(); // platform such as PC/Mac
$productDescription->getFactSheets(); // description in different langauges
$productDescription->getReleases(); // release dates
$productDescription->getEditions(); // editions
$productDescription->getDeveloperHomepage(); // game developer homepage
$productDescription->getKeywords(); // keywords
$productDescription->getGameLanguages(); // languages 
$productDescription->getOfficialTitle(); // official title
$productDescription->getDeveloperName(); // game developer name
$productDescription->getEanCodes(); // EAN codes
$productDescription->getLastUpdate(); // last game update
$productDescription->getCategory(); // category of game 
$productDescription->getPhotos(); // urls photo 
$productDescription->getExtensionPacks(); // extension packs
$productDescription->getVideos(); // urls video
$productDescription->getProductId(); // product id

Retrieve account details, balance value and available credit, _(*21)

$account = $client->getAccount();
$account->getFullName(); // name of account
$account->getEmail(); // email
$account->getTotalToUse(); // total money to use, balance + credit
$account->getCurrentBalance(); // current balance value
$account->getCurrentCredit(); // current credit value

Create order, _(*22)

$createdOrder = Order::createOrder(
        [
            [
                "productId" => "6313677f-5219-47e4-a067-7401f55c5a3a",
                "quantity" => "2",
            ],
        ], null);

foreach ($createdOrder->getProducts() as $product) {

     $product->getProductId();
     $product->getUnitPrice();

     foreach ($product->getCodes() as $code) {
          $code->getCodeId();

          if ($code->isPreOrder()) {
              echo "<b>Code has been pre-ordered!</b>" . " <br>";
          }

          if ($code->isText()) {
              echo "Text code to use: <b>" . $code->getCode() . "</b><br>";
          }

          if ($code->isImage()) {
              $fullPath = \CodesWholesale\Util\Base64Writer::writeImageCode($code, "./my-codes");
              echo "Product has been saved in <b>" . $fullPath . "</b><br>";
          }
     }
}

Receive notifications about product changes via Codeswholesale postback request, _(*23)

To receive notifications from CodesWholesale, first you have to configure your postback URL that will be responsible for handling CodesWholesale requests. In order to do that, follow these steps:, _(*24)

Sign in to CodesWholesale
Go to API tab
Configure and test your post back url

If the URL has been successfully configured, you should be able to handle CodesWholesale requests as follow, _(*25)

$client->registerStockAndPriceChangeHandler(function (array $stockAndPriceChanges) {
    foreach ($stockAndPriceChanges as $stockAndPriceChange) {
        /**
         * Here you can save changes to your database
         *
         * @var StockAndPriceChange $stockAndPriceChange
         */
        echo $stockAndPriceChange->getProductId();
        echo $stockAndPriceChange->getQuantity();

        $prices = $stockAndPriceChange->getPrices();

        foreach ($prices as $price) {
            /**
             * @var Price $price
             */
            echo $price->getRange();
            echo $price->getValue();
        }

        echo "<hr>";
    }
});

$client->registerHidingProductHandler(function (Notification $notification) {
    /**
     * Here you can request for product which was hidden or just hide it
     * using provided productId
     */
    echo $notification->getProductId();
});

$client->registerPreOrderAssignedHandler(function (AssignedPreOrder $notification) {
    /**
     * Here you can request for ordered product using productId
     */
    echo $notification->getOrderId();
});

$client->registerUpdateProductHandler(function (Notification $notification) {
    /**
     * Here you can request product which was updated.
     * It can be image, name or other product parameter.
     */
    echo $notification->getProductId();
});

$client->registerNewProductHandler(function(Notification $notification) {
    /**
     * Here you can request product which was updated.
     * It can be image, name or other product parameter.
     */
    echo $notification->getProductId();
});

$client->handle(SIGNATURE);

If you send test request from the API tab and your script is configured to work with sandbox environment, it will download ten fake images., _(*26)

You can check "examples" directory for more samples and details., _(*27)

Copyright & Licensing

This project is licensed under the Apache 2.0 Open Source License., _(*29)

For additional information, please see:, _(*30)

fkooman OAuth2 client: https://github.com/fkooman/php-oauth-client

The Versions

15/06 2018

dev-master

9999999-dev https://github.com/youailu1/codeswholesale-sdk-php

A PHP wrapper for CodesWholesale's API

library codeswholesale-sdk

A PHP wrapper for CodesWholesale's API

youailu1/codeswholesale-sdk

The README.md

CodesWholesale PHP SDK

Installation

Via Composer:

Create your CodesWholesale account

Getting Started

Copyright & Licensing

The Versions

dev-master

The Requires

The Development Requires

by CodesWholesale.com

2.1.5

The Requires

The Development Requires

by CodesWholesale.com

2.1.4

The Requires

The Development Requires

by CodesWholesale.com

2.1.3

The Requires

The Development Requires

by CodesWholesale.com

2.1.2

The Requires

The Development Requires

by CodesWholesale.com

2.1.1

The Requires

The Development Requires

by CodesWholesale.com

2.1

The Requires

The Development Requires

by CodesWholesale.com

2.0

The Requires

The Development Requires

by CodesWholesale.com

1.0.2

The Requires

The Development Requires

by CodesWholesale.com

1.0

The Requires

The Development Requires

by CodesWholesale.com

1.0.1

The Requires

The Development Requires

by CodesWholesale.com

1.0.13.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.12.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.10.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.11.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.9.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.8.beta

The Requires

The Development Requires

by CodesWholesale.com

1.0.7.beta