PHPackages                             netvlies/bolopenapi-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. netvlies/bolopenapi-bundle

ActiveLibrary[API Development](/categories/api)

netvlies/bolopenapi-bundle
==========================

The Bol.com Open Api is an RESTfull API wich you can use to communicate with the Bol.com webshop catalogue. This bundle makes it very easy to use this API as a service within your Symfony 2 application.

2142[1 issues](https://github.com/netvlies/NetvliesBolOpenApiBundle/issues)PHP

Since Apr 5Pushed 14y ago11 watchersCompare

[ Source](https://github.com/netvlies/NetvliesBolOpenApiBundle)[ Packagist](https://packagist.org/packages/netvlies/bolopenapi-bundle)[ RSS](/packages/netvlies-bolopenapi-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

BolOpenApiBundle
----------------

[](#bolopenapibundle)

[![Build Status](https://camo.githubusercontent.com/3ab3d06a8602de15675535ed6dc2a883a086105e3cca1a1f2e067c9051fd543a/68747470733a2f2f7365637572652e7472617669732d63692e6f72672f6e6574766c6965732f4e6574766c696573426f6c4f70656e41706942756e646c652e706e67)](http://travis-ci.org/netvlies/NetvliesBolOpenApiBundle)

The [Bol.com Open Api](http://developers.bol.com/documentatie/handleiding/) is an RESTfull API wich you can use to communicate with the Bol.com webshop catalogue. This bundle registers the [Bol OpenAPi PHP SDK](https://github.com/netvlies/bol-openapi-php-sdk) in the denpendency injection container wich makes it very easy to use this API as a service within your Symfony 2 application.

You need to have a developer key to use this API. You can get one by [registering at the Bol.com developer center](https://developers.bol.com/inloggen/?action=register).

**NOTE** this bundle is in development and cannot yet be used in an production enviroment.

License
-------

[](#license)

This bundle is released under the MIT license. See the complete license here:

```
Resources/meta/LICENSE

```

Installation
------------

[](#installation)

### Download

[](#download)

Add the following to your `deps` file:

```
[Buzz]
    git=git://github.com/kriswallsmith/Buzz.git
    target=/Buzz

[bol-openapi-php-sdk]
    git=git://github.com/netvlies/bol-openapi-php-sdk.git

[NetvliesBolOpenApiBundle]
    git=git://github.com/netvlies/NetvliesBolOpenApiBundle.git
    target=/bundles/Netvlies/Bundle/BolOpenApiBundle

```

Next, run the vendors script:

```
$ php bin/vendors install

```

### Register the namespace

[](#register-the-namespace)

Register the Netvlies namespace in your `app/autoload.php` file:

```
$loader->registerNamespaces(array(
    // ...
    'Netvlies\\Bundle'          => __DIR__.'/../vendor/bundles',
    'Buzz'                      => __DIR__.'/../vendor/Buzz/lib',
    'BolOpenApi'                => __DIR__.'/../vendor/bol-openapi-php-sdk/src',
    // ...
));

```

### Initialize the bundle

[](#initialize-the-bundle)

Register the bundle in `app/AppKernel.php`:

```
public function registerBundles()
{
    return array(
        // ...
        new Netvlies\Bundle\BolOpenApiBundle\NetvliesBolOpenApiBundle(),
        // ...
    );
}

```

Configuration
-------------

[](#configuration)

Next step is to configure the bundle in `app/config/config.yml`:

```
netvlies_bol_open_api:
    access_key:         YOUR_ACCESS_KEY
    secret_access_key:  YOUR_SECRET_ACCESS_KEY

```

Using it
--------

[](#using-it)

The API is now available as a service from the service container:

```
class WelcomeController extends Controller
{
    public function indexAction()
    {
        // ...
        $bolApi = $this->get('netvlies_bol_open_api.api');
        // ...
    }
}

```

### Search for products / categories

[](#search-for-products--categories)

The searchresults operation returns product information by supplying keywords or ISBN/EAN. The operation has filtering and paging options.

```
class WelcomeController extends Controller
{
    public function indexAction()
    {
        // ...
        $term = 'PHP';
        $options = array(
            // Set your options here
        );
        $bolApi = $this->get('netvlies_bol_open_api.api');
        $searchResult = $bolApi->searchResults($term, $options);
        // ...
    }
}

```

### List products / categories

[](#list-products--categories)

The listresults operation returns various product lists, based on list type and category. The category is based on the id, which can be obtained by the category list request.

For available list types see the [documentation](http://developers.bol.com/documentatie/handleiding/).

```
class WelcomeController extends Controller
{
    public function indexAction()
    {
        // ...
        $type = 'toplist_default';
        $categoryIdAndRefinements = '87';
        $options = array(
            // Set your options here
        );
        $bolApi = $this->get('netvlies_bol_open_api.api');
        $listResult = $bolApi->listResults($type, $categoryIdAndRefinements, $options);
        // ...
    }
}

```

### Get product information

[](#get-product-information)

The products operation gets detailed information for products.

```
class WelcomeController extends Controller
{
    public function indexAction()
    {
        // ...
        $productId = '1002004011800815';
        $bolApi = $this->get('netvlies_bol_open_api.api');
        $productResponse = $bolApi->products($productId);
        // ...
    }
}

```

Documentation
-------------

[](#documentation)

Take a look at the [Bol OpenApi PHP SDK](https://github.com/netvlies/bol-openapi-php-sdk) for more examples and configuration settings. Further documentation about the API can be found at the [Bol.com developer center](http://developers.bol.com/documentatie/handleiding/).

Testing
-------

[](#testing)

Running the tests from the projectfolder of your Symfony 2 application:

```
phpunit -c app/ vendor/bundles/Netvlies/Bundle/BolOpenApiBundle/

```

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance10

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/42ee5904cfa308574ecc37759c9c01b9765a211c5a36b30022be7a9eaf18f8e2?d=identicon)[krizon](/maintainers/krizon)

---

Top Contributors

[![krizon](https://avatars.githubusercontent.com/u/880695?v=4)](https://github.com/krizon "krizon (53 commits)")

### Embed Badge

![Health badge](/badges/netvlies-bolopenapi-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/netvlies-bolopenapi-bundle/health.svg)](https://phpackages.com/packages/netvlies-bolopenapi-bundle)
```

###  Alternatives

[stripe/stripe-php

Stripe PHP Library

4.0k143.3M480](/packages/stripe-stripe-php)[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[facebook/php-business-sdk

PHP SDK for Facebook Business

90821.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

74513.7M114](/packages/meilisearch-meilisearch-php)[google/gax

Google API Core for PHP

265103.1M454](/packages/google-gax)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
