https://github.com/terminal42/webling-api

API client for webling.ch
https://github.com/terminal42/webling-api

Last synced: 23 days ago
JSON representation

API client for webling.ch

• Host: GitHub
• URL: https://github.com/terminal42/webling-api
• Owner: terminal42
• License: mit
• Created: 2015-05-07T15:22:15.000Z (over 9 years ago)
• Default Branch: main
• Last Pushed: 2023-08-29T05:39:08.000Z (over 1 year ago)
• Last Synced: 2024-11-18T09:59:34.167Z (about 2 months ago)
• Language: PHP
• Homepage:
• Size: 124 KB
• Stars: 5
• Watchers: 9
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# terminal42/webling-api

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

```bash

$ composer.phar require terminal42/webling-api ^2.0@dev

```

If you are using Symfony, we recommend using our [Webling Bundle](https://github.com/terminal42/webling-bundle).

## Usage

```php

$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:

```php

$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 ###

```php

$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

```php

$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")'