BioTime SDKPHP SDK for the ZKTeco BioTime API

What it does ​

BioTime devices and servers expose a REST API for attendance transactions, employees, devices (terminals), departments, positions, areas, and resignations — but every call needs a bearer token, that token expires, pagination has to be walked by hand, and every response is an untyped array.

BioTime SDK handles all of that for you:

• Authenticates automatically — obtains a device token on first use, caches it, and transparently re-authenticates on a 401.
• Handles pagination — every list resource exposes list() for a single page and all() to walk every page for you.
• Returns typed DTOs — readonly objects like Employee, Device, AttendanceRecord, with the full raw payload still available via ->raw.
• Normalizes errors — every failed request throws ApiException (or AuthenticationException) with the HTTP status and raw response body attached.
• Works anywhere — a plain, framework-agnostic core, with an optional auto-discovered Laravel service provider.

Who it's for ​

PHP developers integrating a ZKTeco BioTime device or BioTime server into an HR system, attendance dashboard, payroll pipeline, or any application that needs employee, device, or attendance data — in plain PHP or inside a Laravel app.

Supported PHP versions ​

Install it ​

composer require tes/biotime-sdk

A minimal example ​

use BioTime\BioTime;

$biotime = new BioTime(); // reads BIOTIME_* env vars, or config/biotime.php

$employee = $biotime->employees()->find('EMP001');

echo $employee->firstName;

That's a full authenticated request — no manual token handling, no manual JSON decoding.

Supported resources ​

Laravel support ​

BioTime SDK ships an optional, auto-discovered Laravel service provider. Install the package in a Laravel app and BioTime::class is already bound in the container — no manual registration required. See Laravel integration.

Where to go next ​

• New to the SDK? Start with Introduction and Quick start.
• Need a specific resource? Jump straight to Resources.
• Looking for exact method signatures? See the API reference.