q-delivery / lf-api
API for LF
Installs: 55 421
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 4
Forks: 0
Open Issues: 0
Requires
- php: >=7.3
- ramsey/uuid: ^3.9
- symfony/http-client: ^4.4 || ^5.1
- symfony/mime: ^4.4 || ^5.1
- symfony/string: ^5.0
- thecodingmachine/safe: ^1.0
- webmozart/assert: ^1.7
Requires (Dev)
- ergebnis/composer-normalize: ^2.2
- friendsofphp/php-cs-fixer: ^2.16
- phpstan/extension-installer: ^1.0
- phpstan/phpstan: ^0.12.14
- phpstan/phpstan-webmozart-assert: ^0.12.2
- phpunit/phpunit: ^9.0
- thecodingmachine/phpstan-safe-rule: ^1.0
README
Usage
Setup
use Gansel\LF\Api\FallApi; use Symfony\Component\HttpClient\HttpClient; $baseUri = 'https://....'; $username = '...'; $password = '...'; $client = HttpClient::create([ 'auth_basic' => [$username, $password], 'max_duration' => 0, ]); $fallApi = new FallApi($baseUri, $client);
Create Fall
use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $fallApi->create($payload);
Get Fall
use Gansel\LF\Api\Domain\Value\Fall\FallUuid; use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $fallApi->get( FallUuid::fromString('123-456-789'), // the Fall UUID );
Update Fall
Only works before calling a Transition!
use Gansel\LF\Api\Domain\Value\Fall\FallUuid; use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $fallApi->update( FallUuid::fromString('123-456-789'), // the Fall UUID [ 'field' => 'value', // ... ] );
Set Leadsale values
use Gansel\LF\Api\Domain\Value\Fall\FallUuid; use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $now = new DateTime(); $fallApi->updateLeadsaleValues( FallUuid::fromString('123-456-789'), // the Fall UUID true, // or false, the decision by the User $now, // a \DateTimeInterface, when the decision was made by the user 'Please contact him on monday 6pm', // a string, when is the best time to contact the user, or null '030 / 123456789', // a string, with a local phone number, or null '0175 / 123456789', // a string, with a mobile phone number, or null );
Upload File to Fall
use Gansel\LF\Api\Domain\Value\Fall\FallUuid; use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $fallApi->uploadFile( FallUuid::fromString('123-456-789'), // the Fall UUID '/var/test/testfile.txt', // use the absolute filepath 'Fahrzeugschein', // a prefix which can be added to the filename false // wether this file should be marked as new in LF or not );
Apply Transition
use Gansel\LF\Api\Domain\Value\Fall\FallUuid; use Gansel\LF\Api\FallApi; $fallApi = new FallApi(/* ... */); $fallApi->applyTransition( FallUuid::fromString('123-456-789'), // the Fall UUID 'einreichen' // the transition which should be applied );
NOTE
create()
and get()
already return a FallUuid
which can be used to upload a file or apply a transition!