Implemenation of communication with ADOL API endpoints

dev-master 2019-01-25 21:32 UTC

This package is auto-updated.

Last update: 2020-12-26 02:06:58 UTC


Build Status Licence Downloads this Month Downloads total Latest stable PHPStan


The development is under AsisTeam s.r.o.. Feel free to use and contribute.



composer require asisteam/adol


State Version Branch PHP
development ^0.1 master >= 7.1
production ^1.0 master >= 7.1


This package communicates with following ADOL APIs:

  • Watchdog (to be used for assigning watchdog items (insolvencies and estates) to watchdog and checking changes made on these items.)
  • Property (to be used for retrieving detail information about property entities (lands/buildings/building units/persons))

Note: In order to communicate with ADOL APIs you must have your own private token string. This token is provided by ADOL.

Basic principles

For every provided API a separate client class is created (please see Client/WatchDog/..., Client/Property/...). In order to create the client, you must instantiate it by passing at least a valid token string to it's constructor. Or you can replace the default GuzzleHttp client with your custom http client that implements ClientInterface. If using GuzzleHttp client you can also pass a third optional constructor parameter, that is a request options array that will be appended to every request made by the http client. By using this options array, you can set client timeouts etc. for all client calls. Please see available Guzzle options at

When doing a call two exceptions can be thrown.

  • The RequestException is being thrown if request is invalid. The request will not be performed.
  • The ResponseException is thrown whenever request has been sent and response from ADOL server contains invalid status or misses some data.

How to run tests and check code

Code quality assurance: composer qa Code PHPSTAN: composer phpstan

Unit and Integration tests: composer tests

Note: As you are charged for all request performed to real API, integration tests are skipped by default. In order to run integration tests edit tests/Cases/Integration/AbstractTestCase and fill your private token and delete Environment::skip line in setUp() method.

Nette bridge

You can configure clients as Nette Framework DI services and you will be able to use following services:

Watchdog API

  • adol.watchdog.insolvency

Property API

    adol: AsisTeam\ADOL\Bridges\Nette\DI\AdolExtension
    token: "your dedicated adol token"
    options: [
        timeout: 20