PHPackages                             topsoft4u/pq-api-connector - 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. topsoft4u/pq-api-connector

ActiveLibrary[API Development](/categories/api)

topsoft4u/pq-api-connector
==========================

Allows you to connect to API instances running on ProQoS platform.

1.1.0(1mo ago)08MITPHPPHP &gt;=7.4CI passing

Since Apr 18Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/TopSoft4U/pq-api-connector)[ Packagist](https://packagist.org/packages/topsoft4u/pq-api-connector)[ Docs](https://topsoft4u.com)[ RSS](/packages/topsoft4u-pq-api-connector/feed)WikiDiscussions main Synced 2w ago

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

API Connector for websites using ProQoS backend services
========================================================

[](#api-connector-for-websites-using-proqos-backend-services)

Type-safe PHP connector for websites using ProQoS backend services.

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

[](#requirements)

- Minimum PHP Version: 7.4
- Dependencies: ext-curl, ext-json

Application
-----------

[](#application)

This connector can be used for the following websites:

Website📕 Documentation[e-hedo.pl](https://e-hedo.pl)[📕 LINK](https://e-hedo.pl/apidocs)[magboss.pl](https://magboss.pl)[📕 LINK](https://magboss.pl/apidocs)[b2b.onesto-energy.pl](https://b2b.onesto-energy.pl)[📕 LINK](https://b2b.onesto-energy.pl/apidocs)[hedo-pets.com](https://hedo-pets.com)[📕 LINK](https://hedo-pets.com/apidocs)**Note:** For each website, you need a separate API key. To get one, please use the contact form on specific website.

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

[](#installation)

You can install the connector via Composer using the following command:

```
composer require topsoft4u/pq-api-connector
```

Usage
-----

[](#usage)

Each method has its own example in the [examples](example) directory.

For explanation of each method, please refer to the API documentation links mentioned earlier.

Functions
---------

[](#functions)

- Type-safe methods and responses with null-type support.
- Client (connector) validations before sending requests.
- Error handling with exceptions.
- Option to change output language.
- Option to change the output format (JSON/XML).
- You can fetch the JSON/XML file without parsing (usable for testing).
- Test mode for POST methods (sends data to the server, but it's not saved).
- Optional `limit` / `page` pagination on list endpoints (see `PaginatedRequest`).

Testing
-------

[](#testing)

A PHPUnit test suite covers every response DTO. Fixtures under `tests/Fixtures/`mirror the real (lowercase-keyed) API response shapes.

The full matrix (PHP 7.4 → 8.5) runs in isolated, dedicated containers — no host PHP or shared `vendor/`:

```
# One version
docker compose run --rm php83

# The whole matrix
bash scripts/test.sh
```

To run locally with your own PHP (requires ext-curl, ext-dom, ext-mbstring, ext-xml, ext-xmlwriter):

```
composer install
vendor/bin/phpunit --no-coverage
vendor/bin/phpstan analyse   # level 10, no baseline/ignores
```

A standalone runner that needs neither PHPUnit nor the analysis extensions is also available, useful for quick smoke checks:

```
php tests/verify_standalone.php
```

CI runs the same matrix on every push and pull request (see `.github/workflows/tests.yml`).

Releasing a new version
-----------------------

[](#releasing-a-new-version)

1. Update the version in the `composer.json` file with `bash /scripts/bump_version.sh`.
2. Finish the release with `bash /scripts/commit_tag_push.sh` - which will create a new tag and push it to the repository.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance92

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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.

###  Release Activity

Cadence

Every ~810 days

Total

2

Last Release

40d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/544349?v=4)[Maczuga](/maintainers/Maczuga)[@Maczuga](https://github.com/Maczuga)

---

Top Contributors

[![Maczuga](https://avatars.githubusercontent.com/u/544349?v=4)](https://github.com/Maczuga "Maczuga (38 commits)")

---

Tags

apiconnectorproqos

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/topsoft4u-pq-api-connector/health.svg)

```
[![Health](https://phpackages.com/badges/topsoft4u-pq-api-connector/health.svg)](https://phpackages.com/packages/topsoft4u-pq-api-connector)
```

###  Alternatives

[m165437/laravel-blueprint-docs

API Blueprint Renderer for Laravel

22880.1k](/packages/m165437-laravel-blueprint-docs)[akeneo/magento-connector-bundle

Akeneo PIM bundle to export to Magento platform

582.2k](/packages/akeneo-magento-connector-bundle)[bmeme/eventbrite_connector

PHP Library for integration with Eventbrite API v3

151.1k](/packages/bmeme-eventbrite-connector)

PHPackages © 2026

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