README

该库提供了对 XML 和 JSON smsintel API 进行请求的通用接口。

• 依赖关系
• 安装
• 快速入门
• 发送短信
• 群组和联系人
• 账户
• 报告

依赖关系

该库需要 CURL 扩展和 PHP 5.5.9 或更高版本。

安装

通过 Composer

composer require seregazhuk/smsintel-api

快速入门

// You may need to amend this path to locate composer's autoloader
require('vendor/autoload.php'); 

use seregazhuk\SmsIntel\SmsIntel;

$sender = SmsIntel::create('login', 'password');

// send sms
$result = $sender->send('phoneNumber', 'From', 'Your message text');

发送短信

向一个手机号码发送短信

$result = $sender->send('phoneNumber', 'From', 'Your message text');

您可以通过数组传递手机号码

$phones = [
 '79999999999'
 '79999999991'
 '79999999992'
];
$result = $sender->send($phones, 'From', 'Your message text');

通过 ID 取消短信

$result = $sender->cancel($smsId);

请求源名称

$result = $sender->requestSource('FromPHP');

群组和联系人

通过手机号码获取联系人信息

$contact = $sender->getPhoneInfo('79999999999');

获取所有联系人

$contacts = $sender->getContacts();

特定群组的联系人

$groupId = 1;
$contacts = $sender->getContacts($groupId);

通过手机号码获取联系人

$phone = '79999999999';
$contacts = $sender->getContacts(null, $phone);

// or with group:
$groupId = 1;
$contacts = $sender->getContacts($groupId, $phone);

创建新的联系人

$contactInfo = [
	'idGroup' => 1 // required
	'phone'   => '79999999999' // required
	'f'       => 'Second Name',
	'i'       => 'First Name',
	'o'       => 'Middle Name',
	'bday'    => 'YYYY-mm-dd',
	'sex'     => 1 // 1 - male, 2 - female
];
$result = $sender->addContact($contactInfo);

通过手机号码删除联系人

$sender->removeContact('79999999999');

您可以可选地传递群组 ID

$groupId = 1;
$sender->removeContact('79999999999', $groupId);

获取所有群组

$groups = $send->getGroups();

通过 ID 或名称获取群组

$groups = $sender->getGroups($groupId);
$groups = $sender->getGroups(null, $groupName);

创建新的联系人组

$result = $sender->createGroup('NewGroup');

通过 ID 编辑群组名称

$result = $sender->editGroup($newName, $groupId);

账户

获取账户信息

$result = $sender->getAccountInfo();

获取余额

$result = $sender->getBalance();

使用折扣券

$result = $sender->checkCoupon('couponCode');

仅检查折扣券

$result = $sender->checkCoupon('couponCode', false);

报告

通过手机号码获取特定时期的报告

$result = $sender->getReportByNumber($dateFrom, $dateTo, '79999999999');

获取特定时期和所有号码的报告

$result = $sender->getReportByNumber($dateFrom, $dateTo);

通过 smsId 获取报告

$result = $sender->getReportBySms($smsId);

通过源获取特定时期的报告

$result = $sender->getReportBySource($dateFrom, $dateTo, 'FromPHP');

获取所有源特定时期的报告

$result = $sender->getReportBySource($dateFrom, $dateTo);

我该如何感谢你呢？

为什么不给 github 仓库加个星标呢？我很乐意得到关注！

谢谢！