jeffersongoncalves / laravel-demio

1.0.0 2026-09-06 22:27 UTC

Requires

• php: ^8.2
• illuminate/support: ^11.0|^12.0|^13.0
• spatie/laravel-package-tools: ^1.14.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.21
• orchestra/testbench: ^9.0|^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

MIT

• Jefferson Gonçalves

• http
• api
• client
• events
• laravel
• webinar
• webinars
• demio

Published on Packagist.org on 2026-09-06 22:27 UTC

README

Laravel Demio

A lightweight Demio webinar REST API v1 client for Laravel. It wraps the my.demio.com/api/v1 calls behind a small static client, threads your Api-Key/Api-Secret credentials, and centralises 401 detection so callers get a thrown DemioAuthenticationException rather than a silent failure during a bad-credential window.

Features

• Events — events() to list (optionally filtered by upcoming/past/all), event() to fetch one, eventDate() for a specific session date
• Registration — register() to sign a participant up for an event (and optionally a specific date)
• Participants — participants() to list who's registered for a date
• Health check — ping()
• Credential aware — throws DemioAuthenticationException on a 401 so a bad Api-Key/Api-Secret pair doesn't look like "no data"

Installation

composer require jeffersongoncalves/laravel-demio

Optionally publish the config file:

php artisan vendor:publish --tag="demio-config"

Configuration

Add to your .env:

DEMIO_API_KEY=your-api-key
DEMIO_API_SECRET=your-api-secret

Find both at my.demio.com/integrations/api.

Config Options

// config/demio.php
return [
    'api_key' => env('DEMIO_API_KEY'),
    'api_secret' => env('DEMIO_API_SECRET'),
    'base_url' => env('DEMIO_BASE_URL', 'https://my.demio.com/api/v1'),
    'timeout' => (int) env('DEMIO_TIMEOUT', 8),
];

Usage

use JeffersonGoncalves\Demio\DemioClient;

// Health check
DemioClient::ping();

// List events
$events = DemioClient::events();
$upcoming = DemioClient::events('upcoming'); // upcoming|past|all

// Fetch a single event / date
$event = DemioClient::event('event-id');
$date = DemioClient::eventDate('event-id', 'date-id');

// Register a participant
DemioClient::register('event-id', 'Jane Doe', '[e-mail]', dateId: 'date-id', refUrl: 'https://example.com');

// List participants for a date
$participants = DemioClient::participants('date-id');

Handling authentication failures

use JeffersonGoncalves\Demio\Exceptions\DemioAuthenticationException;

try {
    $events = DemioClient::events();
} catch (DemioAuthenticationException $e) {
    // Api-Key/Api-Secret is missing, wrong, or revoked.
}

Testing

composer test

Static Analysis

composer analyse

Code Formatting

composer format

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.