README

一个简单的PHP库，用于帮助利用Sendmode API。Sendmode是一家100%爱尔兰拥有的，多次获奖的大规模短信提供商。

Sendmode库具有以下功能

• 发送短信（有/无计划）
• 发送批量短信（有/无计划）
• 获取余额
• 获取投递报告

请访问Sendmode以获取更多服务详情。

安装

手动安装 将 lib/sendmode.php 文件包含到您的项目中。

或者

自动安装 通过 Composer composer require kreative/sendmode

快速入门

通过Sendmode API发送短信就像这样简单

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

// Send SMS
$result = $sms->send($phonenumber, $message);
// API response is returned as a SimpleXML object in $result.

使用

实例化

类实例化需要一个Sendmode用户名、密码、发送者ID，以及可选的返回格式。

$username=''; // Your Sendmode Username.
$password=''; // Your Sendmode Password.
$senderid=''; // Sender ID SMS that is displayed to recipients.
$format='json|array'; // Optional return format. Default is SimpleXML object.

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid, $format);

立即发送单个短信

通过send()方法立即发送短信。客户ID是可选参数。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

// Send a single SMS
$phonenumber=''; // Phone number in the correct format.
$message=''; // Message to send.
$customerid=''; // Optional message UID used to track delivery reports.

$result = $sms->send($phonenumber, $message, $customerid);
// API response is returned as a SimpleXML object in $result.

在计划的时间发送单个短信

通过send()方法在您选择的时间发送短信。客户ID是可选参数。日期和时间参数都是必需的。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

// Send Scheduled SMS
$phonenumber=''; // Phone number in the correct format.
$message=''; // Message to send.
$customerid=''; // Optional message UID used to track delivery reports.
$date=''; // in d/m/Y e.g. Feb 1st 2016 = 01/02/2016.
$time=''; // in H:i e.g. 1:15PM = 13:15.

$result = $sms->send($phonenumber, $message, $customerid, $date, $time);
// API response is returned as a SimpleXML object in $result.

立即向多个接收者发送短信

通过sendbatch()方法立即向多个接收者发送短信。电话号码应该是正确格式化的数字数组。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

// Send Scheduled SMS
$phonenumbers=array(); // Array of Phone numbers in the correct format.
$message=''; // Message to send.

$result = $sms->sendbatch($phonenumber, $message);
// API response is returned as a SimpleXML object in $result.

在计划的时间向多个接收者发送短信

通过sendbatch()方法在您选择的时间向多个接收者发送短信。电话号码应该是正确格式化的数字数组。为了计划投递，日期和时间参数都是必需的。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

// Send Scheduled SMS to multiple recipients.
$phonenumbers=array(); // Array of Phone numbers in the correct format.
$message=''; // Message to send.
$date=''; // in d/m/Y e.g. Feb 1st 2016 = 01/02/2016.
$time=''; // in H:i e.g. 1:15PM = 13:15.

$result = $sms->sendbatch($phonenumber, $message, $customerid, $date, $time);
// API response is returned as a SimpleXML object in $result.

检索投递报告

您可以通过getdeliveryreport()方法使用在发送短信时定义的UID（客户ID）检索短信的投递状态。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

$customerid=''; // Your UID Customer ID used in the original send request.

$result = $sms->getdeliveryreport($customerid);
// API response is returned as a SimpleXML object in $result.

检索账户余额

您的账户余额（短信信用）可以通过getbalance()方法检索。

// Instantiate the class
$sms = new Sendmode($username, $password, $senderid);

$result = $sms->getbalance();
// API response is returned as a SimpleXML object in $result.

许可证

许可协议为GPL v.3 (tldr)