bol.com OpenAPI PHP client

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

Client library with example code for using the bol.com Open API Version 4. If you need a client/example for Version 3 of the Open API you can use https://github.com/devbolcom/bolcom-openapi-php-client/tree/bolcom-openapi-php-client-v3

If you want to contribute to this library. You can do a Fork and a Pull request on this repo.

The library contains the following requests that are also included in the example script:

  • Ping request
  • Product request
  • Recommendation request
  • RelatedProducts request
  • Offer request
  • Lists request
  • Search request
  • Sessions request
  • Basket requests
  • Wishlist requests
  • setReferrer request (You need to ask extended permission from Developer Center team for this request)
  • Auth requests (You need to ask extended permission from Developer Center team for this request)

What are the files included:

Client

  • Request.php:
  • Setup connection with the server
  • Send session with header
  • Client.php:
  • Example code todo a request
  • Accessories.php, Basket.php, BasketItem.php, BasketItemProduct.php, Category, CategoryRefinement.php, Offers.php, Product.php, ProductFamilies.php and Product.php
  • Example classes for getting the objects

Example

  • Example.php
  • Main class to run the application
  • index.php
  • Call to the class "Example" with key, format and debug_mode and a global function to load the classes

Minimum requirements:

  • PHP 5.6 (or higher)

Installation and running the example:

  1. Get the code by forking or downloading the zip or installing Composer
  2. Upload all files (keep the directory structure) to a web-server
  3. Edit the example file "examples/Example.php" to add the right AccessKeyID (request this key at https://partnerblog.bol.com/register/), response format (xml/json) and debug mode bool (0/1)
  4. Open the browser and call the URL where your index.php file is located

Developer Documentation

https://partnerblog.bol.com/documentatie/open-api/

Basic Example

See the examples/ directory for examples of the key client features.

function __autoload($className)
{
    $fileName = preg_replace('/^BolCom\\\\(\w+)/', 'src/bolcom/$1.php', $className);
    if (file_exists($fileName)) {
        return require_once $fileName;
    }
}

$apiClient = new BolCom\Client('YOUR_APP_KEY', 'json');
$response = $apiClient->getProduct('1002004010708531');
var_dump($response);

Using Composer

composer require "bolcom/bolcom-openapi-php-client" "~2.3"

When using composer, classes are autoloaded automatically.

Running Tests

APP_KEY=YOUR_APP_KEY phpunit