Spryng PHP API Library
Hi, welcome to the documentation for the Spryng PHP API Library. This guide contains practical information on how to use the library. Full PHPDOC can be found in this repository., (*1)
Installation and initialization
Using composer, (*2)
The easiest way to install the libary is using composer:, (*3)
composer require spryng/spryng-api-http-php
When the installation is complete, you can initialize Spryng like so:, (*4)
require( 'vendor/autoload.php');
use SpryngApiHttpPhp\Client;
$spryng = new Client('username', 'password', 'My Company');
Without composer, (*5)
If you're not yet using composer, you can use the autoloader:, (*6)
require ('SpryngApiHttpPhp/src/Spryng/Api/Autoloader.php');
$spryng = new Client('username', 'password', 'My Company');
Sending a SMS
To send an SMS, you should use the Client::sms->send() method. It takes the following parameters:, (*7)
-
$recipient Phone number you're sending the sms to
-
$body Body of the sms
-
$options Additional parameters like allowlong and route
Options, (*8)
There are a number of options you can specify with your request. The requirements for these options are available in the general documentation., (*9)
-
route Enter your assigned route.
-
reference An optional reference for delivery reports.
-
allowlong Weather you want to allow Long SMS or not. Should be true or false.
-
rawencoding ISO/UTF encoding
Full example, (*10)
require( 'vendor/autoload.php')
use SpryngApiHttpPhp\Client;
$spryng = new Client('username', 'password', 'My Company');
try
{
$spryng->sms->send('31612345678', 'A sample message!', array(
'route' => 'business',
'allowlong' => true
'reference' => 'ABC123456789'
'rawencoding' => false)
);
}
catch (InvalidRequestException $e)
{
echo $e->getMessage();
}
Requesting credit balance
Alongside the ability to send SMS messages, it's also possible to request your current credit balance. This method does not require any parameters and can be used like this:, (*11)
require( 'vendor/autoload.php')
use SpryngApiHttpPhp\Client;
$spryng = new Client('username', 'password', 'My Company');
echo 'Current credit balance: ' . $spryng->sms->checkBalance();