PHPackages                             bolcom/bolcom-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. bolcom/bolcom-openapi-php-client

ActiveLibrary[API Development](/categories/api)

bolcom/bolcom-openapi-php-client
================================

Client library for the bol.com Open API

2.3.0(8y ago)2565.0k—8.3%22[1 PRs](https://github.com/devbolcom/bolcom-openapi-php-client/pulls)1Apache-2.0PHPPHP >=5.6

Since Mar 13Pushed 6y ago7 watchersCompare

[ Source](https://github.com/devbolcom/bolcom-openapi-php-client)[ Packagist](https://packagist.org/packages/bolcom/bolcom-openapi-php-client)[ Docs](https://developers.bol.com)[ RSS](/packages/bolcom-bolcom-openapi-php-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (1)

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

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

[![Build Status](https://camo.githubusercontent.com/08294e334e856c17ad1d8d144d54d3799e971537f484cf539888229814ab3a28/68747470733a2f2f7472617669732d63692e6f72672f646576626f6c636f6d2f626f6c636f6d2d6f70656e6170692d7068702d636c69656e742e706e67)](https://travis-ci.org/devbolcom/bolcom-openapi-php-client)[![Latest Stable Version](https://camo.githubusercontent.com/e60dc5038ac3fbff1bd7c626f81e060daacb889532f86c90103cc22aef3d934b/68747470733a2f2f706f7365722e707567782e6f72672f626f6c636f6d2f626f6c636f6d2d6f70656e6170692d7068702d636c69656e742f762f737461626c65)](https://packagist.org/packages/bolcom/bolcom-openapi-php-client)[![Total Downloads](https://camo.githubusercontent.com/2f383be41b791ed5150901cf9bb16bcf57d8c0c961c52a176ca478dfa4d52f7d/68747470733a2f2f706f7365722e707567782e6f72672f626f6c636f6d2f626f6c636f6d2d6f70656e6170692d7068702d636c69656e742f646f776e6c6f616473)](https://packagist.org/packages/bolcom/bolcom-openapi-php-client)[![Latest Unstable Version](https://camo.githubusercontent.com/2864393e84c22febde75f60f341b567eeddb011fb7566f9f0fd958dfb40b07fe/68747470733a2f2f706f7365722e707567782e6f72672f626f6c636f6d2f626f6c636f6d2d6f70656e6170692d7068702d636c69656e742f762f756e737461626c65)](https://packagist.org/packages/bolcom/bolcom-openapi-php-client)[![License](https://camo.githubusercontent.com/a76a5855a555a2a0b109582a36573bd80d5e1e7a7c763ab6d389c19661b0b6f5/68747470733a2f2f706f7365722e707567782e6f72672f626f6c636f6d2f626f6c636f6d2d6f70656e6170692d7068702d636c69656e742f6c6963656e7365)](https://packagist.org/packages/bolcom/bolcom-openapi-php-client)

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.6 (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 "bolcom/bolcom-openapi-php-client" "~2.3"
```

When using composer, classes are autoloaded automatically.

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

[](#running-tests)

```
APP_KEY=YOUR_APP_KEY phpunit
```

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity41

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 84.8% 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

2987d ago

PHP version history (2 changes)2.2.0PHP >=5.3.2

2.3.0PHP >=5.6

### Community

Maintainers

![](https://www.gravatar.com/avatar/671bd3221a34e99d537e5c4d626d5c003474634fba4caaa41276acf7468d2135?d=identicon)[derkmdt](/maintainers/derkmdt)

---

Top Contributors

[![derkmdt](https://avatars.githubusercontent.com/u/1083232?v=4)](https://github.com/derkmdt "derkmdt (39 commits)")[![pvankouteren](https://avatars.githubusercontent.com/u/1055598?v=4)](https://github.com/pvankouteren "pvankouteren (3 commits)")[![denvers](https://avatars.githubusercontent.com/u/1016564?v=4)](https://github.com/denvers "denvers (1 commits)")[![floort](https://avatars.githubusercontent.com/u/140608?v=4)](https://github.com/floort "floort (1 commits)")[![jeroenvisser101](https://avatars.githubusercontent.com/u/1941348?v=4)](https://github.com/jeroenvisser101 "jeroenvisser101 (1 commits)")[![koenknol](https://avatars.githubusercontent.com/u/8624877?v=4)](https://github.com/koenknol "koenknol (1 commits)")

---

Tags

openapiBol.com

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[swagger-api/swagger-ui

 Swagger UI is a collection of HTML, Javascript, and CSS assets that dynamically generate beautiful documentation from a Swagger-compliant API.

28.8k45.4M99](/packages/swagger-api-swagger-ui)[darkaonline/l5-swagger

OpenApi or Swagger integration to Laravel

2.9k34.0M112](/packages/darkaonline-l5-swagger)[dedoc/scramble

Automatic generation of API documentation for Laravel applications.

2.1k7.8M57](/packages/dedoc-scramble)[cebe/php-openapi

Read and write OpenAPI yaml/json files and make the content accessable in PHP objects.

49815.4M86](/packages/cebe-php-openapi)[jolicode/slack-php-api

An up to date PHP client for Slack's API

2534.4M12](/packages/jolicode-slack-php-api)[darkaonline/swagger-lume

OpenApi or Swagger integration to Lumen

3372.3M3](/packages/darkaonline-swagger-lume)

PHPackages © 2026

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