netvlies / bol-openapi-php-sdk
The Bol OpenApi SDK for PHP developers enables you to easily develop products over the Bol OpenApi.
Installs: 1 783
Dependents: 1
Suggesters: 0
Security: 0
Stars: 2
Watchers: 10
Forks: 3
Open Issues: 1
Requires
- php: >=5.3.0
- kriswallsmith/buzz: v0.5
This package is not auto-updated.
Last update: 2024-11-03 03:08:25 UTC
README
The Bol.com Open Api is an RESTfull API wich you can use to communicate with the Bol.com webshop catalogue. This library makes it very easy to use this API as a service within your PHP application.
You need to have a developer key to use this API. You can get one by registering at the Bol.com developer center.
License
This library is released under the MIT license. See the complete license in the LICENSE file.
Installation
First install composer and after that install the dependencies.
Requirements
PHP >=5.3.0
Using it
// ..
$httpBrowser = new \Buzz\Browser();
$accessKey = 'ABC';
$secretAccessKey = 'DEF';
$apiClient = new Client($accessKey, $secretAccessKey, $httpBrowser);
// ..
Search for products / categories
The searchresults operation returns product information by supplying keywords or ISBN/EAN. The operation has filtering and paging options.
// ..
$term = 'PHP';
$options = array(
'categoryIdAndRefinements' => null,
'offset' => 0,
'nrProducts' => 10,
'sortingMethod' => SortingMethod::PRICE,
'sortingAscending' => true,
'includeProducts' => true,
'includeCategories' => true,
'includeRefinements' => true
);
$searchResult = $apiClient->searchResults($term, $options);
// ..
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.
// ..
$type = ProductListType::TOPLIST_DEFAULT;
$categoryIdAndRefinements = '87';
$options = array(
'offset' => null,
'nrProducts' => 10,
'sortingMethod' => SortingMethod::TITLE,
'sortingAscending' => true,
'includeProducts' => false,
'includeCategories' => true,
'includeRefinements' => true
);
$listResult = $apiClient->listResults($type, $categoryIdAndRefinements, $options);
// ..
Get product information
The products operation gets detailed information for products.
// ...
$productId = '1002004011800815';
$productResponse = $apiClient->products($productId);
// ...
Enumerations
For a list of the possible enumerations options (for example sorting methods) take a look at the classes within the Enum namespace.
Documentation
Further documentation about the API can be found at the Bol.com developer center.
Testing
Be sure to install the dependencies first and after that just run phpunit in the lib root:
phpunit