Download the PHP package graystackit/laravel-testo-api without Composer

graystackit/laravel-testo-cloud

A Laravel package for the Testo Smart Connect API, built on Saloon 4.

Retrieve historical measurements, alarm events, HACCP task records, device properties, device health status, measuring object configurations, and location hierarchies from Testo Smart Connect — all with a clean, Laravel-native interface.

Requirements

• PHP 8.3+
• Laravel 11, 12, or 13

Installation

Laravel auto-discovers the service provider. Then publish the config file:

Configuration

Add the following to your .env file:

Generate your API key from the Smart Connect home page. Keys are valid for up to one year.

Async Workflow

All data-export endpoints use the same two-step async pattern:

1. Submit a POST request → receive a request_uuid
2. Poll a GET request with that UUID until status is Completed
3. Download each URL in dataUrls using downloadDataFile()

Usage

Resolve TestoCloudClient from the container or inject via constructor.

Measurements POST /v2/measurements • GET /v2/measurements/{uuid}

$from must be strictly before $to — an \InvalidArgumentException is thrown otherwise.

Parse NDJSON measurement data

Alarms POST /v3/alarms • GET /v3/alarms/{uuid}

Retrieve historical alarm events for the configured account.

Tasks POST /v3/tasks • GET /v3/tasks/{uuid}

Retrieve quality-management / HACCP activity records executed by staff.

Device Properties POST /v3/devices/properties • GET /v3/devices/properties/{uuid}

Retrieve device metadata including serial numbers, model codes, firmware versions, calibration status, and equipment relationships.

No date range required — returns current configuration.

Device Status POST /v3/devices/status • GET /v3/devices/status/{uuid}

Retrieve battery level, signal strength, last communication timestamp, firmware version, and serial numbers for all devices.

No date range required — returns current status snapshot.

Measuring Objects POST /v1/measuring-objects • GET /v1/measuring-objects/{uuid}

Retrieve measuring-object configurations including customer_uuid, customer_site, product_family_id, measurement settings, and channel assignments.

No date range required — returns current configuration.

Locations POST /v1/locations • GET /v1/locations/{uuid}

Retrieve the location hierarchy (sites, zones, rooms) associated with the account.

No date range required — returns current location structure.

Data Objects

Submission response — AsyncSubmitResponse

Returned by every submit*() method.

Status response — AsyncStatusResponse

Returned by every check*Status() method.

Helper methods: isCompleted(), isProcessing(), isFailed()

AsyncRequestStatus enum

The enum normalises all API status strings, including "In Progress" → Processing.

Legacy measurement objects

Used by checkRequestStatus() (measurements only):

Error Handling

All client methods throw GraystackIT\TestoCloud\Exceptions\TestoApiException on failure.

submit*Request() methods that accept a date range additionally throw \InvalidArgumentException when $from >= $to.

If TESTO_API_KEY is not configured, a \RuntimeException is thrown on container resolution.

API Endpoint Reference

Base URL: https://data-api.{region}.smartconnect.testo.com

Database Storage

Migration

Run the migration to create the testo_measurements table:

To customise the migration before running it, publish it first:

testo_measurements schema

Model

Disabling automatic storage

Set TESTO_STORE_MEASUREMENTS=false in your .env (or store_measurements => false in config/testo.php) to fetch and parse data without writing to the database.

Artisan Command

Fetches historical measurements from the Testo API, parses the NDJSON response, and — when storage is enabled — persists every row to testo_measurements.

Options

Examples

Console output

Testing

Tests use Saloon's MockClient — no real API calls are made.

License

MIT