terminal42 / webling-api
API client for webling.ch
Fund package maintenance!
terminal42
Other
Requires
- php: ^7.1
- php-http/client-implementation: ^1.0
- php-http/discovery: ^1.0
- php-http/httplug: ^1.0
- php-http/message-factory: ^1.0
- psr/http-message: ^1.0
- symfony/console: ^2.6 || ^3.0 || ^4.0
- symfony/filesystem: ^2.6 || ^3.0 || ^4.0
Requires (Dev)
- php-http/guzzle6-adapter: ^1.1
- phpunit/phpunit: ~4.0
- satooshi/php-coveralls: ~0.6
Suggests
- php-http/guzzle6-adapter: Guzzle or any other httpPlug compatible implementation.
This package is auto-updated.
Last update: 2024-10-29 08:02:41 UTC
README
An API client for the REST API of webling.ch.
This client is currently used for our own projects and might not support all cases. Feel free to open issues or pull requests for questions or feature requests.
Installation
$ composer.phar require terminal42/webling-api ^2.0@dev
If you are using Symfony, we recommend using our Webling Bundle.
Usage
$subdomain = 'meinverein'; $apiKey = 'foobar'; $apiVersion = '1'; $client = new Client($subdomain, $apiKey, $apiVersion); // Example call for member list: $client->get('member');
The EntityManager
If you're looking for a more convenient way to work with the API instead of
calling it directly, you can work with the EntityManager
.
The main issue with the webling API is the fact that requesting resource lists
(e.g. /member
) will only return an array of object ID's instead of
additional data like the member last name or first name.
The EntityList
will take care of this and lazy load the additional details
whenever you need them. That way you can easily iterate over a list of members:
$em = EntityManager::createForAccount($subdomain, $apiKey); $entityList = $em->findAll('member'); foreach ($entityList as $member) { echo $member->getId(); echo $member->getProperty('Name'); var_dump($member->getProperties()); // etc. }
The QueryBuilder
The QueryBuilder components allows to find entities using complex search queries. It is highly recommended to use an IDE with code autocompletion for easy usage.
Example 1: find member by name
$qb = new QueryBuilder(); $query = $qb->where('Firstname')->isEqualTo('Max')->andWhere('Lastname')->isEqualTo('Muster')->build();
Result:
Firstname = "Max" AND Lastname = "Muster"
Example 2: find member by complex conditions
$qb = new QueryBuilder(); $query = $qb ->group( $qb->where('Firstname')->isEqualTo('Max')->andWhere('Lastname')->isEqualTo('Muster') ) ->orGroup( $qb->where('Firstname')->isEqualTo('Muster')->andWhere('Lastname')->isEqualTo('Max') ) ->build() ;
Result: '(Firstname = "Max" AND Lastname = "Muster") OR (Lastname = "Max" AND "Firstname" = "Muster")'