spw 2.0.0

SpWorldsApiForCS 2.0.0

Это библиотека C# для управлением API SpWorlds. Документация к API тут.

Как начать?

Подключение библиотеки происходит через nuget

nuget

dotnet add package spw --version 2.0.0

Команды

Примечание

Можно использывать асиннхронные и синхронные методы

Деректива подключения

using spw;

Создание класса

SpWorlds sp = new SpWorlds("id", "token");

Правильный token и id

await sp.IsSpWalletAsync();
//or
sp.IsSpwallet();

Возвращает bool

Получить баланс

await sp.GetCardInfoAsync();
//or
sp.GetCardInfo();

Возвращает SPCardUser (Типы)

Получить никнейм по DiscordId

await sp.GetUserAsync("DiscordId");
//or
sp.GetUser("DiscordId");

Возвращает SPUser (Типы)

Отправить АРы

await sp.SendPaymentAsync(amount, "receiver", "message");
//or
sp.SendPayment(amount, "receiver", "message");

Возвращает bool

Создать ссылку на оплату

await sp.CreatePaymentAsync(payment); //class SPPayment
//or
sp.CreatePayment(payment); //class SPPayment

Возвращает string(url)

Проверка оплаты

await sp.ValidatorAsync("webhook", "Xbody_hash");
//or
sp.Validator("webhook", "Xbody_hash");

Возвращает bool

Получение аккаунта владельца токена

await sp.GetAccountAsync();
//or
GetAccount();

Возвращает SPAccount (Типы)

Получение карт игрока

await GetCardsAsync(username);
//or
GetCards(username);

Возвращает SPCard[] (Типы)

Установка вебхука для карты

await SetWebhookAsync(webhook);
//or
SetWebhookAsync(webhook);

Возвращает bool

Types

SPAccount

Используется: GetAccount() Содержимое:

int id 
string username 
string status 
string[] roles 
SPCity city 
SPCard[] cards
string createdAt

SPCard

Используется: GetCards(username) Содержимое:

string name 
string number 

SPCardUser

Используется: ** Содержимое:

int balance 
string webhook 

SPCity

Используется: GetAccount() Содержимое:

string id 
string name 
int x 
int y 
bool isMayor

SPItem

Используется: CreatePayment() Содержимое:

string name 
int count 
int amount 
string comment // can be null

SPPayment

Используется: CreatePayment() Содержимое:

SPItem item 
string redirectUrl 
string webhookUrl
string data 

SPTransaction

Используется: После установления webhook {SetWebhookAsync(webhook)}, приходят транзакции (для парса) Содержимое:

string id 
string name 
string type 
string sender_username 
string sender_number 
string receiver_username 
string receiver_number 
string comment 
string createdAt 

SPUser

Используется: GetCardInfo() Содержимое:

string username 
string uuid //Minecraft uuid

Exceptions

BabRequestException

Неправильная форма запроса

UnathorizedException

Неверный token или id

BadGatewayException

Spworlds api отключен