Download the PHP package walinko/sdk without Composer
On this page you can find all versions of the php package walinko/sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package sdk
walinko/sdk (PHP)
Official PHP client for the Walinko public API.
Send transactional WhatsApp messages from PHP with idempotent retries, structured errors, and a tiny dependency footprint (PSR-18 HTTP).
- PHP 8.1+
- PSR-18 HTTP, PSR-17 factories, PSR-3 logging — bring your own
Guzzle/Symfony/whatever, or let
php-http/discoveryfind one - MIT licensed
Install
If your project doesn't already pull in a PSR-18 client (e.g. via
Guzzle, Symfony HTTP Client, or php-http/curl-client), add one too:
Quick start
Looking up a delivery
Errors
Every exception extends Walinko\Exception\WalinkoException. See
docs/error-codes.md for the full mapping.
Retries
The SDK auto-retries idempotently on:
| Trigger | Behaviour |
|---|---|
| Network errors | Exponential backoff with jitter |
| HTTP 429 | Honours Retry-After (capped at 60s) |
| HTTP 500/502/503/504 | Exponential backoff with jitter |
max_retries (default 2) controls how many additional attempts are made.
4xx responses (other than 429) are surfaced immediately — the request is
malformed or the server has rejected it on application grounds, and no
amount of retrying will help.
Idempotency
The SDK auto-generates a UUID Idempotency-Key for every send /
enqueue call so retries are safe end-to-end. Pass idempotency_key
in the args to set your own (e.g. tying a send to your domain object).
The same key is reused on every retry within a single call.
Rate limits
The server enforces 30 req/min/key (sliding window). The SDK exposes the latest known window state via:
Development
License
MIT
All versions of sdk with dependencies
psr/http-client Version ^1.0
psr/http-factory Version ^1.0
psr/http-message Version ^1.0 || ^2.0
psr/log Version ^2.0 || ^3.0
php-http/discovery Version ^1.19