From cb23437772cc2f9671201f190cf007f903bb5dc2 Mon Sep 17 00:00:00 2001 From: Dima yawaflua Andreev Date: Wed, 26 Jun 2024 01:20:00 +0300 Subject: [PATCH 1/4] Update README.md --- README.md | 61 ++++++++++++++++++++++++++++--------------------------- 1 file changed, 31 insertions(+), 30 deletions(-) diff --git a/README.md b/README.md index e678cca..a0e9d73 100644 --- a/README.md +++ b/README.md @@ -1,98 +1,99 @@ -# spworlds API - - [Mih4n](https://github.com/Mih4n/spworlds-csharp-library), . . +# Библиотека для работы с spworlds API +Большинство функций было позаимствовано из библиотеки моего друга - [Mih4n](https://github.com/Mih4n/spworlds-csharp-library), так как писали мы ее вместе. Просьба по этому поводу ничего не писать. -# CS +# CS Библиотека сайтов СП - dotnet API . API [](https://github.com/sp-worlds/api-docs). +Это библиотека для dotnet для упрощения API сайтов СП. Документация к API [тут](https://github.com/sp-worlds/api-docs). -## +## Установка - CLI -(`dotnet`), NuGet . +Вы можете установить эту библиотеку при помощи CLI +(`dotnet`), NuGet или альтернативного пакетного менеджера. ```bash dotnet add package spworlds ``` -## +## Использование ```cs ... -// ID , , -var spw = new SPWorldsApi("[ ]", "[ ]"); +// При создании объекта вы должны передать ID и Токен карты, в порядке, указанном ниже +var spw = new SPWorldsApi("[ваш айди]", "[ваш токен]"); ``` -## +## Использование -### +### Инициализировать платежную форму - , , . +Если вы хотите выставить счет для оплаты в арах у себя на сайте, или же в стороннем приложении, используйте этот метод. - 16 , `https://example.com/success`, `https://api.example.com/webhook` , `SomeString`. , , ID , . +Получение ссылки на страницу оплаты 16 АР, после успешной оплаты пользователь перейдет со страницы оплаты на `https://example.com/success`, а сайт СП отправит запрос на `https://api.example.com/webhook` с данными этого платежа, в том числе и `SomeString`. Последнее поле можно использовать, например, для ID заказа, так как он возвращается вместе с вебхуком об успешной оплате. ```cs const url = await sp.InitPayment( [ - new PaymentItems() { Name = " ", Count = 1, Price = 16, Comment = " "} + new PaymentItems() { Name = "Тестовая оплата", Count = 1, Price = 16, Comment = "Это пример тестовой оплаты в вашем сайте или приложении"} ], "https://example.com/success", "https://api.example.com/webhook", "SomeString" ); ``` - +ИЛИ ```cs [HttpPost("/create_payment_url/")] public async Task GetCreatePaymentFunction([FromBody] PaymentData paymentData) { const url = await sp.InitPayment(paymentData); - // + // Ваша логика } ``` -### +### Перевод АРов на другую карту - 16 11111 " !" +Перевод 16 АР на карту с номером 11111 и комментарием "С днем рождения!" ```cs -await sp.CreateTransaction("11111", 16, " !"); +await sp.CreateTransaction("11111", 16, "С днем рождения!"); ``` -### +### Получение баланса карты ```cs int balance = await sp.GetCardBalance(); ``` -### +### Получение ника игрока - ID Discord , . +Метод принимает ID игрока в Discord и возвращает его ник, если у него есть вход на сервер. ```cs IUser user = await sp.GetUser("111111111111111111"); if (user.Name == "yawaflua") { - // + // ваша логика } ``` -### ( ) - - SkinPart ( 64, 128 .., , , ) - User, : +### Получение скина(части скина) игрока +Метод принимает один из элементов енам-класса SkinPart и разрешение скина(советуется использовать 64, 128 и т.д., но если вам требуется использовать специфичные значения, например на сайте, указывайте как хотите) +Метод является сабметодом класса User, так что выглядит это так: ```cs IUser user = await sp.GetUser("111111111111111111"); const faceUrl = user.GetSkinPart(SkinPart.face); ``` -### - , , , , , : +### Подтверждение вебхука +Метод рабочий, но то, что присылается от сайта вместе с вебхуком от оплаты невозможно дешифровать, все же, если очень надо, то вот: ```cs bool IsWebHook = await sp.ValidateWebHook(WebHookText, X_Body_Hash); ``` + ## Contributing - , pull . \ No newline at end of file +Если вы хотите дополнить или улучшить библиотеку или документацию к ней, то сделайте pull запрос к этому репозиторию. From eb6ce4481215a4bdc2c7039054ef5357790a0176 Mon Sep 17 00:00:00 2001 From: Dima yawaflua Andreev Date: Wed, 26 Jun 2024 01:21:58 +0300 Subject: [PATCH 2/4] Update and rename SPWorldsApi.csproj to spworlds-api.csproj --- SPWorldsApi.csproj => spworlds-api.csproj | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) rename SPWorldsApi.csproj => spworlds-api.csproj (76%) diff --git a/SPWorldsApi.csproj b/spworlds-api.csproj similarity index 76% rename from SPWorldsApi.csproj rename to spworlds-api.csproj index b061514..2c9e85c 100644 --- a/SPWorldsApi.csproj +++ b/spworlds-api.csproj @@ -5,8 +5,8 @@ enable enable enable - spworldsapi - Библиотека, созданная для облегчения работы с API сайта spworlds.ru . Что-то добавить или обновить можно в github проекта. + spworlds-api + Библиотека, созданная для облегчения работы с API сайта spworlds.ru. Что-то добавить или обновить можно в github проекта. MIT 1.0.0 yawaflua From 337a7b9bc1a1dffd54aedecb6f5daf9c5ba27f73 Mon Sep 17 00:00:00 2001 From: Dima yawaflua Andreev Date: Wed, 26 Jun 2024 01:22:42 +0300 Subject: [PATCH 3/4] Update SPWorldsApi.sln --- SPWorldsApi.sln | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/SPWorldsApi.sln b/SPWorldsApi.sln index df0fbdf..181a592 100644 --- a/SPWorldsApi.sln +++ b/SPWorldsApi.sln @@ -3,7 +3,7 @@ Microsoft Visual Studio Solution File, Format Version 12.00 # Visual Studio Version 17 VisualStudioVersion = 17.9.34728.123 MinimumVisualStudioVersion = 10.0.40219.1 -Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SPWorldsApi", "SPWorldsApi.csproj", "{AD0307C9-8042-44D2-B773-4DEB62D27F3D}" +Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "spworlds-api", "spworlds-api.csproj", "{AD0307C9-8042-44D2-B773-4DEB62D27F3D}" EndProject Global GlobalSection(SolutionConfigurationPlatforms) = preSolution From 92a43908925377776003db80c86677aaebe8c036 Mon Sep 17 00:00:00 2001 From: Dima yawaflua Andreev Date: Wed, 26 Jun 2024 01:23:46 +0300 Subject: [PATCH 4/4] Rename SPWorldsApi.sln to spworlds-api.sln --- SPWorldsApi.sln => spworlds-api.sln | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename SPWorldsApi.sln => spworlds-api.sln (100%) diff --git a/SPWorldsApi.sln b/spworlds-api.sln similarity index 100% rename from SPWorldsApi.sln rename to spworlds-api.sln