uflixdesign/sms-api-sdk

UFLIX DESIGN SDK - SMS网关

1.1 2020-01-31 18:54 UTC

This package is auto-updated.

Last update: 2024-09-05 02:02:37 UTC


README

UFLIX DESIGN SDK - SMS网关。

路由。

根据需要和可用性,在需要指定路由时,选择以下之一。

常量可靠性描述
ROUTE_PROMOpromo~70%促销路由,即使送达至DND注册的电话号码也不会。
ROUTE_PROMODNDpromodnd~80%促销路由,但会送达至DND注册的电话号码。
ROUTE_TRANStrans~99%交易路由,会送达至DND注册的电话号码。

对于任何请求,您必须创建SMS网关客户端的实例。

$sms = new UFXDSMSAPI\\Client($user, $pass, $config);  

参数

参数类型默认值描述
$user字符串必需提供账户用户名
$password字符串必需提供账户密码
$config数组可选 []SDK使用GuzzleHttp\\Guzzle请求HTTP API,此选项只是覆盖默认选项。有关更多信息,请参阅Guzzle请求选项

获取账户余额

此方法用于获取账户的短信余额。

$sms->balance(): object|null

失败时返回null,成功时返回包含余额信息的对象。

检查短信服务器是否运行正常。

此方法用于检查我们的短信服务器是否正常运行。

$sms->APIStatus($getException): boolean
参数类型默认值描述
$getException布尔值可选 false如果设置为true,方法将抛出异常,而不是在错误时返回false。

成功时返回true,失败时返回false,如果$getException设置为false。失败时,如果$getException设置为true,则方法将抛出异常。

发送普通短信。

此方法用于通过我们的短信网关发送短信。

$sms->sendSMS($numbers, $message, $route): object
参数类型默认值描述
$numbers字符串 | 数组必需如果为字符串,则为单个电话号码,对于多个使用数组。
$message字符串必需要发送的短信正文消息。
$route字符串可选将通过该路由发送短信。使用类常量指定类中可用的路由

返回状态的对象。

发送OTP。

将OTP(一次性密码)发送到用于稍后验证的号码。注意,您不需要生成或将OTP存储到数据库中。所有工作都由我们的API完成。

所有OTP都有一个验证时间范围,通过$ttl给出。我们的API足够智能,即使在未按顺序送达的情况下也能验证OTP。因此,如果用户发送2个或更多的OTP但它们未按顺序送达,则可以使用其中一个OTP进行验证。

$sms->sendOTP($action, $number, $message, $ttl): boolean
参数类型默认值描述
$action字符串必需最大长度:32个字符。一个命名的操作,描述OTP是什么。
$number字符串必需发送OTP的电话号码。
$message字符串可选 默认:''用于将自动生成的OTP替换的模板消息。如果没有指定,将使用默认模板。
$ttl整数可选 默认:5生存时间。OTP验证的有效时间。值以分钟为单位。

成功时返回true,否则返回false

验证OTP。

验证之前发送到号码的OTP。

《action》定义了OTP的作用,因此action应该与发送OTP时使用的action相同。这样,一个应用可以有多个OTP验证的位置,每个位置将使用不同的action名称。例如:`login`、`cod`等。

$sms->verifyOTP($action, $number, $code): boolean
参数类型默认值描述
$action字符串必需最大长度:32个字符。一个命名action,用于描述OTP的作用。
$number字符串必需之前发送OTP的手机号码。
$code字符串必需发送到手机上的OTP。

如果OTP验证成功则返回`true`,否则返回`false`