PHPackages                             wedesignit/bol.com-openapi-php-client - 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. wedesignit/bol.com-openapi-php-client

ActiveLibrary[API Development](/categories/api)

wedesignit/bol.com-openapi-php-client
=====================================

Client library for the bol.com Open API

v4.0.1(9y ago)034Apache-2.0PHPPHP >=5.3.2

Since Apr 20Pushed 9y ago1 watchersCompare

[ Source](https://github.com/WeDesignIt/Bol.com-OpenAPI-PHP-Client)[ Packagist](https://packagist.org/packages/wedesignit/bol.com-openapi-php-client)[ Docs](https://developers.bol.com)[ RSS](/packages/wedesignit-bolcom-openapi-php-client/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (4)Used By (0)

bol.com OpenAPI PHP client
==========================

[](#bolcom-openapi-php-client)

Note: this repository is based on this original repo: It contains some updated code that is preventing the original repo from working correctly:

- Seller properties improvement: [devbolcom/bolcom-openapi-php-client#13](https://github.com/devbolcom/bolcom-openapi-php-client/pull/13)
- Links to directories fix: [devbolcom/bolcom-openapi-php-client#14](https://github.com/devbolcom/bolcom-openapi-php-client/pull/14)
- Semantic versioning

Over time, this library will be improved. Requests can be made by raising issues.

A word on the semantic versioning
---------------------------------

[](#a-word-on-the-semantic-versioning)

The major version of this library stands for the version of the bol API for which it works. Currently this is API v4, so all tags are v4.x.x

Original description of the library
-----------------------------------

[](#original-description-of-the-library)

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

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:
-----------------------------------------------------------------------------------------

[](#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:
----------------------------

[](#what-are-the-files-included)

### Client

[](#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)

- 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:
---------------------

[](#minimum-requirements)

- PHP 5.3.2 (or higher)

Installation and running the example:
-------------------------------------

[](#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 ), 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
-----------------------

[](#developer-documentation)

Basic Example
-------------

[](#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
--------------

[](#using-composer)

```
composer require "wedesignit/bol.com-openapi-php-client" "~4.0"
```

When using composer, classes are autoloaded automatically.

Running Tests
-------------

[](#running-tests)

```
APP_KEY=YOUR_APP_KEY phpunit
```

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

3358d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9ae5357d893c402ae052f7e1705f6071de01dfa303800e6f9ba3ef27188fbea8?d=identicon)[pvankouteren](/maintainers/pvankouteren)

---

Top Contributors

[![pvankouteren](https://avatars.githubusercontent.com/u/1055598?v=4)](https://github.com/pvankouteren "pvankouteren (6 commits)")

---

Tags

phpopenapiBol.com

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/wedesignit-bolcom-openapi-php-client/health.svg)

```
[![Health](https://phpackages.com/badges/wedesignit-bolcom-openapi-php-client/health.svg)](https://phpackages.com/packages/wedesignit-bolcom-openapi-php-client)
```

###  Alternatives

[harmbandstra/swagger-ui-bundle

Exposes swagger UI inside your Symfony project through a route (eg. /docs)

40881.6k](/packages/harmbandstra-swagger-ui-bundle)[bolcom/bolcom-openapi-php-client

Client library for the bol.com Open API

2465.3k1](/packages/bolcom-bolcom-openapi-php-client)

PHPackages © 2026

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