Download the PHP package seventhings/customer-api-php without Composer
On this page you can find all versions of the php package seventhings/customer-api-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download seventhings/customer-api-php
More information about seventhings/customer-api-php
Files in seventhings/customer-api-php
Package customer-api-php
Short Description PHP SDK for the seventhings API
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package customer-api-php
seventhings PHP SDK
PHP SDK for the seventhings asset tracking API.
Installation
Add the repository to your composer.json:
Then install:
Requirements: PHP ^8.5, Guzzle 7 (only runtime dependency).
Quick Start
Usage by Module
Auth
Objects
Rooms
Locations
Room and location list(), get(), and patch() results are flat field maps,
whether the API sends a flat record or a {uuid, fields} envelope. Custom
fields are preserved, and the envelope UUID is included if the inner map has
no uuid field. The all() iterators use the same normalization.
Users
Persons
Files
Tasks
Rentals
Resource History
Omitting options uses the API defaults: page 1, 50 entries per page.
The API caps history pages at 200 entries. Use HistoryListOptions to
request subsequent pages; resources without recorded changes return empty
items. History does not accept list filters or sorting options.
PDF Reports
create() returns a binary PDF string. Each call generates a new document;
the API does not store it. Failed requests throw the usual ApiException.
Field Definitions
CircularityHub
Error Handling
ListOptions & Filtering
Use ListOptions for paginated, filtered, and sorted requests on Objects, Rooms, Locations, and Rentals.
all() is available on objects, rooms, locations (yielding Fields),
and on persons / users (yielding their typed response objects).
Tasks and Users have their own option classes:
Scope & Limitations
- No auto-refresh — tokens are not automatically refreshed; call
$client->auth->refresh()and$client->setToken()manually. - No retry logic — failed requests are not retried automatically.
- No caching — all calls hit the API directly.
- CircularityHub uses integer IDs, not UUIDs.
- History pagination is manual — use
HistoryListOptions; list iterators are described above.
Running Tests
License
MIT
