Download the PHP package besmartand-pro/bsap-sensor-client without Composer
On this page you can find all versions of the php package besmartand-pro/bsap-sensor-client. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download besmartand-pro/bsap-sensor-client
More information about besmartand-pro/bsap-sensor-client
Files in besmartand-pro/bsap-sensor-client
Package bsap-sensor-client
Short Description Framework-independent PHP client for the BeSmartAnd.Pro Sensor API.
License MIT
Informations about the package bsap-sensor-client
BeSmartAnd.Pro Sensor Client
Klient publicznego REST API sensor.besmartand.pro dla PHP 8.4+. Korzysta z transportu PSR-18 i fabryki żądań PSR-17 dostarczonych przez aplikację.
Instalacja
Użycie w czystym PHP
Zakres API
getSensorHistory(string $sensorId): array wywołuje GET /api/client/sensors/{id}/history z nagłówkiem X-Api-Token. Zwraca listę obiektów SensorMeasurement:
| Metoda | Typ zwracany |
|---|---|
getSensor() |
string — etykieta sensora |
getTemperature() |
float |
getHumidity() |
?float |
getDatetime() |
?DateTimeImmutable |
Serwer zwraca maksymalnie 200 ostatnich pomiarów. Kolejność odpowiedzi jest zachowywana. Obecny endpoint nie udostępnia paginacji ani filtrów dat. Token organizacji jest dostępny w panelu w sekcji Tokeny API, a identyfikator sensora w sekcji Sensory.
Biblioteka obsługuje publiczne API klienta. Endpointy urządzeń, parowania i administratora mają inne mechanizmy autoryzacji i pozostają poza jej zakresem.
Błędy
ApiException: odpowiedź inna niż HTTP 200. MetodygetStatusCode()igetRetryAfter()zwracają kod i opcjonalny nagłówekRetry-After(sekundy lub data HTTP). Dotyczy m.in. 401, 403, 404, 429 oraz 5xx. Treść błędnej odpowiedzi nie jest dodawana do wyjątku.InvalidResponseException: niepoprawny JSON, struktura danych lub data pomiaru.Psr\Http\Client\ClientExceptionInterface: błąd transportu przekazywany bez zmian.InvalidArgumentException: niepoprawna konfiguracja albo pusty identyfikator sensora.
Klient nie ponawia żądań automatycznie. PSR-18 nie podąża automatycznie za przekierowaniami; przekazana implementacja transportu powinna przestrzegać tego kontraktu. Konfigurację timeoutu ustawia aplikacja. Nagłówek X-Api-Token nie powinien trafiać do logów.
Development
Testy używają odpowiedzi HTTP w pamięci. Nie kontaktują się z produkcyjnym API.
Licencja MIT.
All versions of bsap-sensor-client with dependencies
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^1.1 || ^2.0