releans/releansapi

此包已 弃用 并不再维护。未建议替代包。

Releans SDK 允许开发者将其代码中的 Releans 服务。您可以在几分钟内开始使用。

v2.0.0 2019-09-16 19:27 UTC

This package is auto-updated.

Last update: 2022-07-14 08:34:44 UTC


README

Releans SDK 允许开发者将其代码中的 Releans 服务。您可以在几分钟内开始使用。

composer require releans/releansapi

创建 Releans 账户

首先,如果您还没有,请通过 注册 Releans 账户,并在仪表板 API 页面上记下您的 API 密钥。

初始化

身份验证

为了设置 API 客户端的身份验证和初始化,您需要以下信息。

参数 描述
oAuthAccessToken 您的 API 密钥

API 客户端可以按以下方式初始化。

$oAuthAccessToken = 'oAuthAccessToken'; // OAuth 2.0 Access Token

$client = new ReleansAPILib\ReleansAPIClient($oAuthAccessToken);

类参考

控制器列表

类: MessageController

获取单例实例

可以通过 API 客户端访问 MessageController 类的单例实例。

$message = $client->getMessage();

方法: getAllMessages

列出账户发送的所有消息。

function getAllMessages($accept)

参数

参数 标签 描述
接受 必需 /

示例用法

$accept = '*/*';

$result = $message->getAllMessages($accept);

方法: getViewMessage

返回消息的详细信息。

function getViewMessage(
        $id,
        $accept)

参数

参数 标签 描述
id 必需 消息ID
接受 必需 /

示例用法

$id = 'id';
$accept = '*/*';

$result = $message->getViewMessage($id, $accept);

方法: createSendSMSMessage

发送单个消息。

function createSendSMSMessage(
        $accept,
        $senderId,
        $mobileNumber,
        $body)

参数

参数 标签 描述
接受 必需 Accept
senderId 必需 发送消息的发送者ID。
mobileNumber 必需 应接收消息的手机号码。
body 必需 消息文本。

示例用法

$accept = 'Accept';
$senderId = 'senderId';
$mobileNumber = 'mobileNumber';
$body = 'message';

$result = $message->createSendSMSMessage($accept, $senderId, $mobileNumber, $body);

完整代码示例

use ReleansAPILib\APIException;
use ReleansAPILib\ReleansAPIClient;


$oAuthAccessToken = 'YOUR_API_KEY'; // OAuth 2.0 Access Token
$client = new ReleansAPIClient($oAuthAccessToken);
$message = $client->getMessage();
$accept = 'Accept';
$senderId = 'Sender_Name_ID';
$mobileNumber = '+44123456789';
$body = 'Hello from Releans';

$result = $message->createSendSMSMessage($accept, $senderId, $mobileNumber, $body);

返回控制器列表

类: SenderController

获取单例实例

可以从API客户端访问SenderController类的单例实例。

$sender = $client->getSender();

方法: getSenderNameDetails

返回发送者名称的详细信息。

function getSenderNameDetails(
        $id,
        $accept)

参数

参数 标签 描述
id 必需 待添加参数描述
接受 必需 待添加参数描述

示例用法

$id = 'sender-id';
$accept = '*/*';

$result = $sender->getSenderNameDetails($id, $accept);

方法: createSenderName

创建一个新的发送者ID,以便使用它发送消息。

function createSenderName(
        $accept,
        $contentType,
        $body)

参数

参数 标签 描述
接受 必需 待添加参数描述
contentType 必需 待添加参数描述
body 必需 待添加参数描述

示例用法

$accept = 'text/plain';
$contentType = 'text/plain';
$body = 'Your sender name';

$result = $sender->createSenderName($accept, $contentType, $body);

方法: getAllSenders

列出与账户关联的所有发送者名称

function getAllSenders($accept)

参数

参数 标签 描述
接受 必需 待添加参数描述

示例用法

$accept = '*/*';

$result = $sender->getAllSenders($accept);

返回控制器列表

类: BalanceController

获取单例实例

可以从API客户端访问BalanceController类的单例实例。

$balance = $client->getBalance();

方法: getBalance

获取您的可用余额

function getBalance($accept)

参数

参数 标签 描述
接受 必需 待添加参数描述

示例用法

$accept = 'text/plain';

$result = $balance->getBalance($accept);

返回控制器列表

=======

入门

Releans SDK 允许开发者将其代码中的 Releans 服务。您可以在几分钟内开始使用。

composer require releans/php-client-sdk

初始化

身份验证

为了设置 API 客户端的身份验证和初始化,您需要以下信息。

参数 描述
oAuthAccessToken OAuth 2.0 访问令牌

API 客户端可以按以下方式初始化。

$oAuthAccessToken = 'oAuthAccessToken'; // OAuth 2.0 Access Token

$client = new ReleansAPILib\ReleansAPIClient($oAuthAccessToken);

类参考

控制器列表

类: MessageController

获取单例实例

可以通过 API 客户端访问 MessageController 类的单例实例。

$message = $client->getMessage();

方法: getAllMessages

列出账户发送的所有消息。

function getAllMessages($accept)

参数

参数 标签 描述
接受 必需 待添加参数描述

示例用法

$accept = '*/*';

$result = $message->getAllMessages($accept);

方法: getViewMessage

返回消息的详细信息。

function getViewMessage(
        $id,
        $accept)

参数

参数 标签 描述
id 必需 待添加参数描述
接受 必需 待添加参数描述

示例用法

$id = 'id';
$accept = '*/*';

$result = $message->getViewMessage($id, $accept);

方法: createSendSMSMessage

发送单个消息。

function createSendSMSMessage(
        $accept,
        $senderId,
        $mobileNumber,
        $message)

参数

参数 标签 描述
接受 必需 待添加参数描述
senderId 必需 发送消息的发送者ID。
mobileNumber 必需 应接收消息的手机号码。
message 必需 消息文本。

示例用法

$accept = 'Accept';
$senderId = 'senderId';
$mobileNumber = 'mobileNumber';
$message = 'message';

$result = $message->createSendSMSMessage($accept, $senderId, $mobileNumber, $message);

返回控制器列表

类: SenderController

获取单例实例

可以从API客户端访问SenderController类的单例实例。

$sender = $client->getSender();

方法: getSenderNameDetails

返回发送者名称的详细信息。

function getSenderNameDetails(
        $id,
        $accept)

参数

参数 标签 描述
id 必需 待添加参数描述
接受 必需 待添加参数描述

示例用法

$id = 'sender-id';
$accept = '*/*';

$result = $sender->getSenderNameDetails($id, $accept);

方法: createSenderName

创建一个新的发送者ID,以便使用它发送消息。

function createSenderName(
        $accept,
        $contentType,
        $body)

参数

参数 标签 描述
接受 必需 待添加参数描述
contentType 必需 待添加参数描述
body 必需 待添加参数描述

示例用法

$accept = 'text/plain';
$contentType = 'text/plain';
$body = 'Your sender name';

$result = $sender->createSenderName($accept, $contentType, $body);

方法: getAllSenders

列出与账户关联的所有发送者名称

function getAllSenders($accept)

参数

参数 标签 描述
接受 必需 待添加参数描述

示例用法

$accept = '*/*';

$result = $sender->getAllSenders($accept);

返回控制器列表

类: BalanceController

获取单例实例

可以从API客户端访问BalanceController类的单例实例。

$balance = $client->getBalance();

方法: getBalance

获取您的可用余额

function getBalance($accept)

参数

参数 标签 描述
接受 必需 待添加参数描述

示例用法

$accept = 'text/plain';

$result = $balance->getBalance($accept);

返回控制器列表