PHPackages                             endeavour/groeigids-api-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. endeavour/groeigids-api-client

ActiveLibrary[API Development](/categories/api)

endeavour/groeigids-api-client
==============================

Api client for importing GroeiGids articles

1.0.0(1y ago)01.3k↑78.6%1MITPHPPHP ^8.2

Since May 17Pushed 1y ago2 watchersCompare

[ Source](https://github.com/EndeavourPlatforms/groeigids-api-client)[ Packagist](https://packagist.org/packages/endeavour/groeigids-api-client)[ RSS](/packages/endeavour-groeigids-api-client/feed)WikiDiscussions development Synced 2d ago

READMEChangelog (2)Dependencies (8)Versions (4)Used By (1)

Groeigids API client
====================

[](#groeigids-api-client)

The Groeigids API Client is a PHP library designed to interact with the Elkander Groeigids API, making it easy to fetch and manage articles and themes. Swagger documentation of the API can be found [here](https://groeigids-api.elkander.nl/swagger-ui/index.html).

Features
--------

[](#features)

- Fetch articles and themes from the Groeigids API
- JSON schema validation for API responses
- Support for query parameters and sorting
- Custom exceptions for error handling

Requirements
------------

[](#requirements)

- PHP 8.1+
- Composer
- A valid API key for the Groeigids API
- A PSR-18 compatible HTTP client
- A PSR-17 compatible HTTP factory implementation

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

[](#installation)

To install the Groeigids API Client, use Composer:

```
composer require endeavour/groeigids-api-client
```

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

[](#configuration)

To run integration tests, a .env file should be created in the root of the project with the following content:

```
GROEIGIDS_API_KEY=your-api-key-here
```

Usage
-----

[](#usage)

To use the Groeigids API Client, create an instance of the `GroeigidsApiClient` class:

```
use Endeavour\GroeigidsApiClient\Infrastructure\HttpClient\GroeigidsClient;

$client = new GroeigidsClient(
    ClientInterface,
    RequestFactoryInterface,
    new ResponseDataBuilder(),
    new ResponseValidator(new Opis\Validator()),
    getenv('GROEIGIDS_API_KEY')
);
```

Now fetching articles and themes is as simple as calling the `fetchArticles` and `fetchThemeArticles` methods:

```
$articles = $client->fetchArticles();
$themes = $client->fetchThemeArticles();
```

The `fetchArticles` and `fetchThemeArticles` methods accept an optional array of query parameters:

```
$articles = $client->fetchArticles(page: 1, size: 10);
$themes = $client->fetchThemeArticles(page: 2, size: 50);
```

The `fetchArticles` and `fetchThemeArticles` methods also accept an optional TypedArray object containing sorting parameters:

```
$sortParameters = new TypedArray(SortParameter::class, [
    new SortParameter('title', 'asc'),
    new SortParameter('order', 'desc')
]);
$articles = $client->fetchArticles(sort: $sortParameters);
```

Other functions are available to fetch articles by ID, by breadcrumb or those modified after a certain date:

```
$articleById = $client->fetchArticle(1);
$articleByBreadcrumb = $client->fetchArticleByBreadcrumb('article-breadcrumb');
$articlesAfterDate = $client->fetchModfifiedArticlesAfterDate(new DateTime('2020-01-01'))
```

Testing
-------

[](#testing)

To run the unit tests, use PHPUnit (make sure a .env file is present in the root of the project):

```
make up
make test
```

Contributing
------------

[](#contributing)

Contributions are welcome!

Licence
-------

[](#licence)

This project is licensed under the MIT License.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 71.4% 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 ~200 days

Total

2

Last Release

577d ago

Major Versions

0.1.0 → 1.0.02024-12-03

PHP version history (2 changes)0.1.0PHP 8.1.\*

1.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/32a4fe6bcece4eeb8bc5414701abaf02a0761607244f5d64f22a73d7040a34ac?d=identicon)[Endeavour](/maintainers/Endeavour)

---

Top Contributors

[![EndeavourPlatforms](https://avatars.githubusercontent.com/u/103530946?v=4)](https://github.com/EndeavourPlatforms "EndeavourPlatforms (5 commits)")[![patrick-zuurbier](https://avatars.githubusercontent.com/u/135841789?v=4)](https://github.com/patrick-zuurbier "patrick-zuurbier (2 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/endeavour-groeigids-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/endeavour-groeigids-api-client/health.svg)](https://phpackages.com/packages/endeavour-groeigids-api-client)
```

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)[mollie/mollie-api-php

Mollie API client library for PHP. Mollie is a European Payment Service provider and offers international payment methods such as Mastercard, VISA, American Express and PayPal, and local payment methods such as iDEAL, Bancontact, SOFORT Banking, SEPA direct debit, Belfius Direct Net, KBC Payment Button and various gift cards such as Podiumcadeaukaart and fashioncheque.

60216.0M85](/packages/mollie-mollie-api-php)[cakephp/cakephp

The CakePHP framework

8.9k19.5M1.8k](/packages/cakephp-cakephp)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)

PHPackages © 2026

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