jblond/aspsms

ASP SMS API 客户端

v1.0.4 2022-01-13 11:05 UTC

This package is auto-updated.

Last update: 2024-09-13 17:41:52 UTC


README

要将配置文件复制到您的根目录或配置文件夹,或者将值添加到现有的配置中。我建议使用 vlucas/phpdotenv 读取数据。

此库与新的 API https://webapi.aspsms.com/index.html 兼容,比旧 json 接口快得多。

安装

composer require jblond/aspsms

示例

<?php

use jblond\aspsms\Endpoint;

require 'vendor/autoload.php';

//load .env file
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/../');
$dotenv->load();

$endpoint = new Endpoint();
$endpoint->setCredentials($_ENV['KEY'], $_ENV['PASSWORD'], $_ENV['SENDER']);

print_r($endpoint->getCredits());

var_dump($endpoint->sendSMS('Hello You! :)', ['+49555666777'], '2021-06-30T15:20:00+02:00'));

echo '<pre>';
print_r($endpoint->getTrafficStat());
echo '</pre>';

echo '<pre>';
print_r($endpoint->getSendingStat(2021, 6, 1));
echo '</pre>';

// get failed SMS
echo '<pre>';
$report = $endpoint->getSendingStat(date("Y", strtotime("Last month")), date("m", strtotime("Last month")));
foreach ($report as $item){
    if($item['dst'] === 0 || $item['msisdn'] === ''){
        continue;
    }
    print_r($item)
}
echo '</pre>';

echo '<pre>';
print_r($endpoint->getStats());
echo '</pre>';

echo '<pre>';
print_r($endpoint->getPhoneNumbers());
echo '<pre>';

发送 SMS 的正确格式是 Y-m-dTH:i:sP 或 date("c")

例如。

$timestamp = date("c", strtotime("+30 seconds"))

请参阅 php 日期格式

配置

.env

KEY="loremIPsum"
PASSWORD="verySecret"
SENDER="JBlond"
  • KEY = 您的 API 密钥
  • PASSWORD = 您的 API 密码
  • SENDER = 显示在手机上发送的发送者名称

API 端点

官方 API 中有更多端点,但我没有要求它们。请随意从我的存储库中添加这些端点并提交 Pull Request。

许可证

在 MIT 许可下发布。