PHPackages                             oaoa/naturhouse-api-v2 - 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. oaoa/naturhouse-api-v2

ActiveLibrary[API Development](/categories/api)

oaoa/naturhouse-api-v2
======================

API client for Naturhouse CRM

v0.1.0(6y ago)03[2 PRs](https://github.com/oaoa-kamupene/naturhouse-api-v2/pulls)MITPHP

Since Feb 26Pushed 3y ago1 watchersCompare

[ Source](https://github.com/oaoa-kamupene/naturhouse-api-v2)[ Packagist](https://packagist.org/packages/oaoa/naturhouse-api-v2)[ RSS](/packages/oaoa-naturhouse-api-v2/feed)WikiDiscussions master Synced 3d ago

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

Naturhouse CRM sample PHP client library
========================================

[](#naturhouse-crm-sample-php-client-library)

This library is open source client library for Naturhouse CRM, mainly for support affiliate partners. API description

**Naturhouse public API supports**:

- get list of branches
- get list of packages provided for clients
- get list of contact times (possibilities when to call to created contact)
- create contact
- get created contact (to verify its state)

Instalation
-----------

[](#instalation)

using composer:

```
$ composer require oaoa/naturhouse-api-v2
```

Basic usage
-----------

[](#basic-usage)

The simplest scenario is:

1. fetch list of active branches
2. create contact
3. check contact state

```
$configuration = [
'hostname' => 'https://kalendar.naturhouse-cz.cz/api/v2/',
'auth_token' => 'seecret token; you can get one from Naturhouse',
];
$client = new \Naturhouse\Client($configuration);
// fetch list of all active branches
$branches = $client->getBranches();
// prepare contact data
$contact = new \Naturhouse\Entities\Contact();
$contact->setFname('krestni');
$contact->setLname('prijmeni');
$contact->setBranch($branches[0]->getId());
$contact->setNote('testovaci kontakt');
// create contact
try{
    $response = $client->createContact($contact);
    $contactId = $response->getId();
    //fetch contact state
    $fetchedContact = $client->getContact($contactId);
    // print contact state
    var_dump($fetchedContact->getStatus());
} catch(\Naturhouse\Exceptions\ClientException $e) {
    echo $e->getMessage();
}
```

### notes

[](#notes)

Be careful, branches can change in > 10 minutes, so do NOT cache them longer than day. If you create contact to inactive branch, API will respond with error.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity48

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

2268d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/fc362cdfbc3e4051f8f620cf772ca9b8179f010291846362888f22b12a6226fc?d=identicon)[toretak](/maintainers/toretak)

---

Top Contributors

[![toretak](https://avatars.githubusercontent.com/u/2004628?v=4)](https://github.com/toretak "toretak (23 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/oaoa-naturhouse-api-v2/health.svg)

```
[![Health](https://phpackages.com/badges/oaoa-naturhouse-api-v2/health.svg)](https://phpackages.com/packages/oaoa-naturhouse-api-v2)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

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