igormakarov / alphasms.http.api.client
Client for work with alphasms.ua - service HTTP API
Installs: 3 302
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: >=7.4.3 || ^8.0.2
- guzzlehttp/guzzle: ^7.4
Requires (Dev)
- phpunit/phpunit: 9.5.x-dev
README
alphasms.php.api - клієнт для роботи з HTTP API aplhasms.ua сервісу по відправці смс
Увага:
Не реалізована відправка запланованных повідомлень, а також Viber-повідомлень, але для розширення вже є підгрунтя, наприклад класс Viber - залишилося лише дописаті назву полів у стилі camelCase і задати потрібні данні цим полям, а також зверніть увагу на метод toString() - классів які імплементують інтерфейс IMessage
Офіційна документація:
https://alphasms.ua/storage/files/alphasms-api-http-1.5.4.pdf
Підключення:
composer require igormakarov/alphasms.php.api - https://packagist.org/packages/igormakarov/alphasms.http.api.client
require_once 'vendor/autoload.php';
Ініціалізація і робота з клієнтом:
Ініціалізація
$client = new AlphaSmsHttpClient('yourApiKey');
Отримати баланс
$client->getBalance(): float
Переверіка ціни смс по номеру телефона
$client->getSmsPriceByNumber("+yourNumber"): \igormakarov\AlphaSms\SmsPrice - має інформацію про смс з ціною та валютою
Відправка смс
$smsId = $client->sendMessage(new Sms("alphaNameOrPhoneNumber", "to phone", "message text")): int - id смс
Отримати статус повідомлення
$client->getMessageStatus($smsId): \igormakarov\AlphaSms\Message\MessageStatus - має інформацію про статус повідомлення код, та дату
Запуск тестів
composer unit-tests