VKPonchikLib 2.5.2.1

ВНИМАНИЕ! Данная версия устарела. Используйте последнюю версию, если вам нужны все функции API.

• Документация
• Связатся со мной
• LonDev WebSite

VKPonchikLib

Библиотека для использования API донат - сервиса "Пончик" ВКонтакте Используемое API: https://vkdonuts.ru/api

Getting Started

Эта инструкция позволит вам просто и быстро начать работать с API.

Install

Установите Nuget пакет в ваш проект: Package Manager

PM> Install-Package VKPonchikLib

.NET CLI

> dotnet add package VKPonchikLib

Visual Studio Nuget Manager

Проект -> Свойства -> Управление пакетами Nuget -> Обзор -> Поиск -> VKPonchikLib -> Установить

Поддержать разработку проекта

Данная библиотека распространяется бесплатно, но вы можете поддержать ее разработку, отправив средства разработчику

Prerequisites

В библиотеке последней версии реализовано использование CallBack API и отправка запросов к обычному API для получения/изменения информации о донатах В следующем обновлении запранирована переработка CallBack API, а также добавление новых функций

Использование

Создайте экзеспляр класса PonchikClient для дальнейшего использования API

VKPonchikLib.PonchikClient Client = new VKPonchikLib.PonchikClient(SecretKey, ConfirmKey);

Example

Использование CallBack API (Рекомендуется использовать в проектах веб-приложения или ASP.NET):

/* Эвент загрузки страницы ASP.NET */
public partial class CallBack : System.Web.UI.Page
{
    /* Создаем экземпляр класса PonchikClient и передаем ему секретный ключ и код подтверждения */
    VKPonchikLib.PonchikClient Client = new VKPonchikLib.PonchikClient(Base.CDB.GroupID, Base.CDB.APIToken, Base.CDB.SecretKey, Base.CDB.ConfirmKey);

    protected void Page_Load(object sender, EventArgs e)
    {
        string json;
        /* Принимаем входящий поток */
        using (var reader = new StreamReader(Request.InputStream))
        {
            /* Считываем данные в строку */
            json = reader.ReadToEnd();
        }

        /* Объявляем функцию для эвента CallBackNewConfirmation */
        Client.CallBackNewConfirmation += Confirmation;
        /* Объявляем функцию для эвента CallBackNewDonate */
        Client.CallBackNewDonate += Donate;
        /* Объявляем функцию для эвента CallBackNewPaymentStatus */
        Client.CallBackNewPaymentStatus += PaymentStatus;
        /* Объявляем функцию для эвента CallBackError */
        Client.CallBackError += CBError;

        /* Передаем в обработчик CallBack запросов полученный JSON массив */
        Client.CallBackInput(json);
    }

    /* Объявляем функцию для обработки запросов типа confirmation */
    private void Confirmation(string type, string answer)
    {
        // Поместите свой код здесь
    }
    
    /* Объявляем функцию для обработки запросов типа new_donate */
    private void Donate(string type, string answer, object obj)
    {
        // Поместите свой код здесь
    }
    
    /* Объявляем функцию для обработки запросов типа payment_status */
    private void PaymentStatus(string type, string answer, object obj)
    {
        // Поместите свой код здесь
    }
    
    /* Объявляем функцию для обработки запросов типа error */
    private void CBError(string type, string answer, object obj)
    {
        // Поместите свой код здесь
    }
}

Использование Функций PonchikClient.Donate

/* Создаем новый экземпляр класса Donate */
var pl = new VKPonchikLib.PonchikClient.Donate(Convert.ToInt32("01234567"), "APIToken", "SecretKey", "ConfirmKey");
/* Получение списка донатов */
string GetResult = VKPonchikLib.Converters.Serialize.ToJson(pl.Get());
/* Изменить статус доната */
string ChangeStatusResult = VKPonchikLib.Converters.Serialize.ToJson(pl.ChangeStatus(0123456, "Status"));
/* Добавить/изменить ответ сообщества на донат */
string AnswerResult = VKPonchikLib.Converters.Serialize.ToJson(pl.Answer(0123456, "Answer"));
/* Изменить выдачи вознаграждения */
string ChangeRewardStatusResult = VKPonchikLib.Converters.Serialize.ToJson(pl.ChangeRewardStatus(0123456, "Status"));

Использование Функции SendPostJSON

string response = Client.SendPostJSON("https://example.com/", "{ \"json\" }");

Использование Функции SendPostJSON

string response = Client.SendPostJSON("https://example.com/", "{ \"json\" }");

Использование Функции GetErrorCodeInfo

string ErrorDescription = Client.GetErrorCodeInfo(IntErrorCode);