Starline OpenApi for Laravel

Разработчик: Alexander Tischenko.

A compact Laravel client for the StarLine OpenAPI — vehicle state, remote commands, events, GPS tracks. Built on top of starline-openapi-php, using Guzzle for HTTP and Laravel Cache for token storage.

• Laravel 12, PHP >= 8.2
• Full SLID auth chain with token caching (Laravel cache)
• Automatic re-authentication on HTTP 401
• Captcha and SMS support (with pluggable OCR)
• Typed models: Device, DeviceState, UserInfo
• Facade + DI, publishable config
• Not affiliated with StarLine NPO. Use at your own risk.

Installation

composer require cruide/starline-openapi-laravel
php artisan vendor:publish --tag=starline-config

Add credentials to .env:

STARLINE_APP_ID=123456
STARLINE_APP_SECRET=your-app-secret
STARLINE_LOGIN=user@example.com
STARLINE_PASSWORD=secret
# Optional
# STARLINE_USER_ID=
# STARLINE_CACHE_STORE=
# STARLINE_CACHE_TTL=86400

App ID / Secret Key are issued at https://my.starline.ru/developer.

Usage

use Cruide\StarlineLaravel\Facades\Starline;

// Profile + devices (typed DTOs)
$info = Starline::user()->info();   // UserInfo
$userId = Starline::user()->id();   // int

$devices = Starline::user()->devices(); // Device[]
foreach ($devices as $device) {
    echo $device->alias();   // "Car A"
    echo $device->isOnline() ? 'online' : 'offline';

    // Live state
    $state = Starline::devices()->state($device->id()); // DeviceState
    echo $state->isArmed() ? 'armed' : 'disarmed';
    echo $state->interiorTemperature();  // °C
    echo $state->batteryVoltage();       // V
    echo $state->latitude(), $state->longitude(); // GPS
    echo $state->mileage();              // km
}

// Commands
Starline::devices()->arm($deviceId);
Starline::devices()->disarm($deviceId);
Starline::devices()->startEngine($deviceId);
Starline::devices()->stopEngine($deviceId);
Starline::devices()->setParam($deviceId, ['webasto' => ['start' => true]]);

// Events & tracks
$events = Starline::devices()->events($deviceId, $periodStart, $periodEnd);
$track  = Starline::devices()->ways($deviceId, $begin, $end);
$types  = Starline::devices()->eventTypes();

// Any endpoint from the docs
Starline::get('/json/v3/device/'.$deviceId.'/data');
Starline::post('/json/v1/device/'.$deviceId.'/set_param', ['security' => ['arm' => true]]);

Or via dependency injection:

use Cruide\StarlineLaravel\Client;

class StarlineController
{
    public function __construct(private Client $starline)
    {
    }
}

How authentication works (SLID)

All further requests carry Cookie: slnet=.... App/SLID tokens and slnet are cached; on a 401 the session is flushed and the chain runs once again automatically. md5/sha1 hashing is mandated by the StarLine protocol.

API reference

Facade / Client

UserApi (via Starline::user())

DeviceApi (via Starline::devices())

Models

All model getters return null for missing fields (safe across firmware versions).

Error handling

Testing

composer install
vendor/bin/phpunit

License

MIT