mapo-89/laravel-heizreport-api

A Heizreport API client for Laravel.

v0.2.0-beta 2025-03-21 00:01 UTC

This package is auto-updated.

Last update: 2025-05-12 01:02:51 UTC


README

Latest Version on Packagist Total Downloads GitHub Actions

A simple Laravel integration for the Heizreport API. This package provides a clean interface to interact with the API.

📖 This README is also available in 🇩🇪 German.

📦 Installation

Install the package via Composer:

composer require mapo-89/laravel-heizreport-api

Add your API token to your .env file:

HEIZREPORT_API_TOKEN=your-token-here

Alternatively, you can load the token dynamically (e.g., from a database). In your AppServiceProvider inside the boot() method:

use Illuminate\Support\Facades\Config;
use App\Models\Integration;

public function boot()
{
    Config::set('heizreport-api.api_token', Integration::getApiToken('Heizreport'));
}

Optionally, you can publish the config file:

php artisan vendor:publish --provider="Mapo89\LaravelHeizreportApi\HeizreportApiServiceProvider" --tag="config"

⚙️ Usage

use Mapo89\LaravelHeizreportApi\Facades\HeizreportApi;

// Example: Fetch all projects
$data = HeizreportApi::make()->projects()->all(); // customize this based on your needs

📚 Full API documentation available at: heizreport.com

✅ Testing

composer test

📒 Changelog

Please see CHANGELOG for recent changes.

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING for details.

🔐 Security

If you discover any security issues, please do not use the issue tracker. Instead, email us directly at info@postler.de.

👥 Credits

📄 License

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

🛠️ Laravel Package Boilerplate

Generated using the Laravel Package Boilerplate.