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();