README

更多信息

Laravel 库，用于操作 SPWorlds API

安装

使用 Composer

composer require anvilm/spworlds

发布配置文件

php artisan vendor:publish --provider='AnvilM\SPWorlds\Providers\SPWorldsServiceProvider'

使用

初始化类对象

use Anvilm\SPWorlds\API;

$SPWorlds = new API($id, $token);

地图信息

方法返回包含地图余额和 webhook 的 JSON 字符串

$SPWorlds->APIService->cardInfo()

获取用户昵称

方法返回包含昵称和 UUID 的 JSON 字符串

$discordId = 'discord_id'; //Discord id игрока

$SPWorlds->APIService->getUsername($discordId);

获取玩家地图

方法返回包含玩家地图数组和地图名称及编号的 JSON 字符串

$username = 'user_name'; //Ник игрока

$SPWorlds->APIService->getCards($username);

获取令牌持有者账户

方法返回包含玩家数据：账户：id, username, minecraftUUID, status, roles, city, cards, createdAt. 城市：id, name, description, x, z, isMayor 地图：id, name, number, color 的 JSON 字符串

$SPWorlds->APIService->getOwner();

在您的网站上支付

方法返回指向支付页面的链接。成功支付后，服务器将向 webhookUrl 发送 POST 请求

//Массив предметов на покупку
$items = [
    [
        'name' => 'item_name', //Имя предмета
        'count' => '10', //Количество предметов
        'price' => '1', //Цена за штуку
        'comment' => 'some comment' //Комментарий
    ]
];

$redirectUrl = 'https://redirect.url'; //Ссылка для переадрессации пользователя
$webhookUrl = 'https://webhook.url'; //Вебхук

$data = 'some data'; //Любая информация

$SPWorlds->APIService->payment($items, $redirectUrl, $webhookUrl, $data);

银行转账

方法返回包含新余额的 JSON 字符串

$receiver = 'receiver card'; //Номер карты получателя
$ammount = '10'; //Сумма
$comment = 'some comment'; //Комментарий к переводу

$SPWorlds->APIService->transaction($receiver, $ammount, $comment);

更改地图 webhook

方法返回包含地图 ID 和新 webhook 的 JSON 字符串

$webhook = 'https://webhook.url'; //Вебхук

$SPWorlds->APIService->setWebhook($webhook);

验证支付

方法返回 true 或 false

$body = $request->getContent(); //JSON тело запроса
$hashHeader = $request->header('X-Body-Hash'); //Хеш тела запроса

$SPWorlds->APIService->validateHash($body, $hashHeader);

授权令牌

方法返回 Bearer 令牌

$SPWorlds->APIService->getAuthorization();