README

Usage

Installation

composer require datana-gmbh/formulario-api

Setup

use Datana\Formulario\Api\FormularioClient;

$baseUri = 'https://api.formulario...';
$token = '...';
$timeout = 10; // optional

$client = new FormularioClient($baseUri, $token, $timeout);

// you can now request any endpoint which needs authentication
$client->request('GET', '/api/something', $options);

Dateneingaben

In your code you should type-hint to Datana\Formulario\Api\DateneingabenApiInterface

Get by Aktenzeichen (string)

use Datana\Formulario\Api\DateneingabenApi;
use Datana\Formulario\Api\FormularioClient;
use Datana\Formulario\Api\Domain\Value\DateneingabenId;

$client = new FormularioClient(/* ... */);

$api = new DateneingabenApi($client);
$response = $api->byAktenzeichen('1abcde-1234-5678-Mustermann');

/*
 * to get the DateneingabenId transform the response to array
 * and use the 'id' key.
 */
$akten = $response->toArray();
$dateneingabenId = DateneingabenId::fromInt($akte['id']);

Get by ID (Datana\Formulario\Api\Domain\Value\DateneingabenId)

use Datana\Formulario\Api\DateneingabenApi;
use Datana\Formulario\Api\FormularioClient;
use Datana\Formulario\Api\Domain\Value\DateneingabenId;

$client = new FormularioClient(/* ... */);

$api = new DateneingabenApi($client);

$id = DateneingabenId::fromInt(123);

$api->getById($id);

Statistics

In your code you should type-hint to Datana\Formulario\Api\StatisticsApiInterface

Get number of invitation mails sent for Mandantencockpit

use Datana\Formulario\Api\StatisticsApi;
use Datana\Formulario\Api\FormularioClient;

$client = new FormularioClient(/* ... */);

$api = new StatisticsApi($client);

$api->numberOfCockpitInvitationMailsSent(); // 42