Share Device Location

Generate a temporary url token that allows sharing a specific device. Other can open the url and see the device location as long as the token is has not expired.

IMPORTANT

The server will not allow sharing when ServerAttributesData -> disableShare is enabled.

Usage

use Carbon\CarbonImmutable;
use ThingsTelemetry\Traccar\Facades\Device;

$expiration = CarbonImmutable::now()->addHours(12);

$share = Device::share(deviceId: 6, expiration: $expiration); // ThingsTelemetry\Traccar\Dto\DeviceShareData

• expiration is a Carbon instance and will be converted to ISO-8601 automatically.
• The token is a plain string suitable for subsequent authenticated calls if supported by your setup.

Results

The response is a ThingsTelemetry\Traccar\Dto\DeviceShareData instance.

$token = $share->token; // 'eyJhbGciOi...'
$url = $share->url; // e.g., 'https://demo.traccar.org/?token=eyJhbGciOi...'
$expiration = $share->expiration; // CarbonImmutable instance
$expiresAt = $expiration->toIso8601String(); // ISO-8601

Errors

• 403 Forbidden: "Sharing is disabled"
• 403 Forbidden: "Temporary user"