Download the PHP package pasquale-cs/zipsms-php-sdk without Composer
On this page you can find all versions of the php package pasquale-cs/zipsms-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Please rate this library. Is it a good library?
Informations about the package zipsms-php-sdk
ZipSMS PHP SDK
SDK PHP ufficiale per ZipSMS Gateway — invio SMS tramite il proprio dispositivo Android via API.
- PHP
>= 8.1, HTTP viaguzzlehttp/guzzle - Integrazione Laravel: ServiceProvider + Facade +
config/zipsms.php - Validazione client-side + eccezioni tipizzate + controlli di sicurezza
Installazione
Uso rapido
Idempotenza (importante)
POST /sms/send richiede l'header Idempotency-Key. L'SDK lo genera da solo
(UUIDv4) se non lo passi — ma per retry sicuri senza doppi invii, passa una
chiave stabile legata al tuo dominio (es. ordine-123):
Stato / lista SMS
Device / Usage (sessione Bearer dashboard)
Laravel
Auto-discovery attivo. Pubblica la config:
Gestione errori
| HTTP | Eccezione | Quando |
|---|---|---|
| 400/422 | ValidationException |
E.164 errato, testo >1600, deviceId/deviceName… |
| 401/403 | AuthenticationException |
API key mancante/revocata |
| 404 | NotFoundException |
Device/SMS non tuo |
| 409 | ConflictException |
Device revocato, transizione illegale |
| 429 | RateLimitException |
Quota esaurita / rate limit (->retryAfterSeconds(), ->errorCode() = API_QUOTA_EXCEEDED…) |
| 5xx/rete | ServerException / NetworkException |
— |
Tutte estendono ZipSmsException (->statusCode(), ->errorCode()). I messaggi
non contengono mai segreti.
Sicurezza (applicata dall'SDK)
- HTTPS obbligatorio (http solo per
localhost/127.0.0.1/*.local/*.test). - Validazione fail-fast: E.164 normalizzato, messaggio 1–1600 char,
Idempotency-KeyASCII stampabile (anti header-injection), credenziali senza whitespace/control-char. - TLS verify sempre attivo, timeout/connect-timeout configurabili.
- Nessun segreto nei log/eccezioni (API key solo nell'header
x-api-key). deviceTokendella creazione device mostrato una volta: conservalo cifrato (es.encrypt()Laravel / vault).
Sviluppo
All versions of zipsms-php-sdk with dependencies
PHP Build Version
Package Version
The package pasquale-cs/zipsms-php-sdk contains the following files
Loading the files please wait ...