PHPackages                             ecollectors/cloud-sdk - 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. ecollectors/cloud-sdk

ActiveLibrary[API Development](/categories/api)

ecollectors/cloud-sdk
=====================

Official PHP/Laravel SDK for the eCollectors Cloud API (M6.2) — generated models and Requests, hand-maintained facade.

v1.0.0(yesterday)00MITPHPPHP ^8.1CI passing

Since Jul 23Pushed yesterdayCompare

[ Source](https://github.com/manishamitl/cloud-sdk-php)[ Packagist](https://packagist.org/packages/ecollectors/cloud-sdk)[ Docs](https://github.com/ecollectors/cloud-sdk-php)[ RSS](/packages/ecollectors-cloud-sdk/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (3)Versions (2)Used By (0)

eCollectors Cloud — PHP/Laravel SDK
===================================

[](#ecollectors-cloud--phplaravel-sdk)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](LICENSE)

The official PHP client for the [eCollectors Cloud API](https://docs.ecollectors.cloud)(M6.2, `ecollectors/cloud-sdk`). Generated models and endpoint definitions, wrapped by a small hand-maintained facade — the only class you ever import is `EcollectorsCloud`.

**Full API reference, authentication guide, and error code reference**: [docs.ecollectors.cloud](https://docs.ecollectors.cloud) — this README stays short on purpose; the docs site is the canonical source, this SDK just wraps it.

Install
-------

[](#install)

```
composer require ecollectors/cloud-sdk
```

Authentication
--------------

[](#authentication)

The platform has two independent auth modes, and this SDK has one constructor for each:

```
use Ecollectors\CloudSdk\EcollectorsCloud;

// An `ec_{env}_…` API key — the data plane (Search, Knowledge Delivery).
$client = EcollectorsCloud::withApiKey('ec_production_...');

// A Sanctum token from register()/login() — self-service account
// management (Organisations, Products, Applications, Environments, Keys).
$client = EcollectorsCloud::withUserToken($token);
```

Examples
--------

[](#examples)

**Search** (data plane, API key):

```
$results = $client->search()->query('kgv half rupee 1912');
```

**Knowledge Delivery** (data plane, API key):

```
$variant = $client->knowledge()->variant('KGV1R-1911-CAL');
```

**Self-service account management** (CloudUser token):

```
$auth = EcollectorsCloud::withApiKey('')->auth()->register([
    'name' => 'Ada Lovelace',
    'email' => 'ada@example.test',
    'password' => 'correct-horse-battery-staple',
]);

$client = EcollectorsCloud::withUserToken($auth->token);

$organisation = $client->organisations()->create(['name' => 'NumisPoint Ltd']);
$product = $client->products()->create($organisation->id, ['name' => 'NumisPoint']);
$application = $client->applications()->create($organisation->id, $product->id, ['name' => 'Website']);
```

Errors
------

[](#errors)

Every failure throws a typed exception under `Ecollectors\CloudSdk\Exceptions`, one per API error code — `NotFoundException`, `ValidationException`, `UnauthenticatedException`, `RateLimitedException`, `ConflictException`, and so on — all extending `EcollectorsCloudException`, which carries the original `status`, `problemCode`, `detail`, and `docsUrl`.

```
use Ecollectors\CloudSdk\Exceptions\NotFoundException;

try {
    $client->knowledge()->variant('NO-SUCH-VARIANT');
} catch (NotFoundException $e) {
    // $e->status === 404, $e->problemCode === 'not_found'
}
```

Contract version
----------------

[](#contract-version)

Every release is generated from a specific, pinned commit of the platform's OpenAPI contract:

```
EcollectorsCloud::contractVersion(); // '452ffd6ab234...'
```

Development
-----------

[](#development)

This package's `src/Generated/` tree is generated, never hand-edited — see `generator/` for the (deliberately narrow) generation logic and `bin/sync-contract` / `bin/generate` for the regeneration workflow.

```
composer install
composer generate   # regenerate src/Generated/ from contract/openapi.yaml
composer test
```

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

Unknown

Total

1

Last Release

1d ago

### Community

Maintainers

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

---

Top Contributors

[![manishamitl](https://avatars.githubusercontent.com/u/299023087?v=4)](https://github.com/manishamitl "manishamitl (5 commits)")

---

Tags

laravelsdkopenapisaloonapi clientecollectors

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/ecollectors-cloud-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/ecollectors-cloud-sdk/health.svg)](https://phpackages.com/packages/ecollectors-cloud-sdk)
```

###  Alternatives

[saloonphp/laravel-plugin

The official Laravel plugin for Saloon

807.1M211](/packages/saloonphp-laravel-plugin)[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1123.7k](/packages/codebar-ag-laravel-docuware)

PHPackages © 2026

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