Laravel ElektraWeb

A clean, typed Laravel SDK for ElektraWeb APIs. Ships the Booking API module today and is structured so further ElektraWeb modules can be added under the same roof (Aenzenith\ElektraWeb\<Module>).

• PHP 8.1+ · Laravel 9, 10, 11, 12 and 13
• Built on Laravel's HTTP client, so Http::fake() works out of the box
• Immutable request objects, typed response objects, provider-agnostic exceptions
• JWT login with cache-backed token reuse and automatic re-login on 401
• Read-through cache with stale fallback for reference data (definitions, params, countries...)
• Every endpoint in the public Booking API docs

Installation

composer require aenzenith/laravel-elektraweb
php artisan vendor:publish --tag=elektraweb-config

ELEKTRAWEB_HOTEL_ID=26780
ELEKTRAWEB_BOOKING_API_KEY=your-api-key
# optional
ELEKTRAWEB_BOOKING_API_URL=https://bookingapi.elektraweb.com/
ELEKTRAWEB_BOOKING_LANGUAGE=EN
ELEKTRAWEB_BOOKING_CURRENCY=EUR

See config/elektraweb.php for every option: auth driver, timeouts, retries, token store and cache TTLs.

Quick start

use Aenzenith\ElektraWeb\Facades\BookingApi;
use Aenzenith\ElektraWeb\BookingApi\Requests\PriceSearch;
use Aenzenith\ElektraWeb\BookingApi\Requests\CreateReservation;
use Aenzenith\ElektraWeb\BookingApi\Requests\Guest;
use Aenzenith\ElektraWeb\BookingApi\Requests\Contact;
use Aenzenith\ElektraWeb\BookingApi\Enums\PaymentType;

$hotel = BookingApi::hotel(); // default hotel from config, or BookingApi::hotel(26780)

// 1. Search rates
$offers = $hotel->rates()->search(
    PriceSearch::make('2026-07-01', '2026-07-05', adults: 2)
        ->withChildren([4])
        ->withCurrency('EUR')
        ->withNationality('DE')
);

$offer = $offers->bookable()->cheapest();

// 2. Book it
$created = $hotel->reservations()->create(
    CreateReservation::fromOffer($offer, '2026-07-01', '2026-07-05', nationality: 'DE')
        ->withGuests([
            Guest::mr('Ada', 'Lovelace'),
            Guest::ms('Grace', 'Hopper'),
            Guest::child('Bo', 'Lovelace', birthday: '2022-03-02'),
        ])
        ->withContact(Contact::make('Ada', 'Lovelace', 'ada@example.com', '+49 30 1234567'))
        ->withPaymentType(PaymentType::NotPaid)
        ->withNotes('Late arrival')
);

$created->reservationId; // 101010101542

You can also inject the module instead of using the facade:

use Aenzenith\ElektraWeb\BookingApi\BookingApi;

public function __construct(private BookingApi $bookingApi) {}

or go through the manager: ElektraWeb::bookingApi().

The API surface

Everything hangs off two entry points: BookingApi::hotel($id) for hotel-scoped endpoints and BookingApi::constants() for system lists.

Every response object keeps the untouched provider body in ->raw (or ->get('dot.path')) so nothing the API returns is ever out of reach, even for endpoints whose payloads are not documented.

Working with offers

$offers->bookable();              // stop-sell / sold-out filtered out
$offers->refundable();
$offers->forRoomType(425897);
$offers->cheapestFirst();
$offers->find($offerId);          // by the provider's offer id
$offers->equivalentTo($oldOffer); // same rate identity when the id changed (e.g. checkout after a re-search)

$offer->totalPrice();             // discounted price when present, else list price
$offer->isBookable();
$offer->cancellationPenalty->isRefundable;

Per-call configuration

BookingApi is immutable; each with* returns a configured copy so tweaks never leak to other callers (safe under Octane / queues).

BookingApi::withLanguage('TR')->hotel()->definitions()->all();
BookingApi::withCurrency('USD')->hotel()->rates()->search($search);
BookingApi::withoutCache()->hotel()->definitions()->params();
BookingApi::withCaptcha($recaptchaToken)->hotel()->guestCancellation()->find($lookup);
BookingApi::withCredentials(new HotelUserCredentials('26780', 'user', 'pass'))->login();
BookingApi::withHeaders(['X-Request-Id' => $id])->hotel()->rates()->search($search);

Authentication

Issued JWTs are stored in the configured cache store until they expire (the exp claim is honoured, falling back to token.ttl_minutes). A 401 from any endpoint triggers one transparent re-login and replay.

Caching

Reference data is cached per bucket (cache.ttl_minutes.*). A second, longer lived copy (cache.stale_minutes) is served when the provider is unreachable, and a StaleCacheServed event is fired so you can alert on it. Prices, availability and every write are never cached.

$hotel->definitions()->forget();       // drop this hotel's cached definitions
BookingApi::constants()->forget();      // drop countries / cities / board types

Errors

All exceptions extend Aenzenith\ElektraWeb\Exceptions\ElektraWebException.

A RequestFailed event is dispatched right before any of these is thrown, which is a convenient single place to log provider problems.

Events

TokenIssued, RequestFailed, StaleCacheServed — plus Laravel's own RequestSending / ResponseReceived HTTP client events.

Testing your integration

Because the SDK uses Laravel's HTTP client you fake it like any other call:

Http::fake([
    'bookingapi.elektraweb.com/login' => Http::response(['token' => 'x.y.z']),
    'bookingapi.elektraweb.com/hotel/*/price/*' => Http::response([...]),
]);

Extending with new modules

ElektraWeb::extend('pms', PmsApi::class);   // implements Aenzenith\ElektraWeb\Contracts\Module
ElektraWeb::module('pms');

Development

composer test      # phpunit
composer analyse   # phpstan level 8
composer format    # pint

The CI matrix runs PHP 8.1–8.5 against Laravel 9–13 with both prefer-lowest and prefer-stable dependency sets.

License

MIT — see LICENSE.