MaxSharp 0.1.3-alpha

MaxSharp

Alpha версия — библиотека активно развивается. API может меняться без предупреждения.

C# библиотека для работы с мессенджером MAX. Предоставляет удобный клиент для взаимодействия с MAX Bot API.

📦 Установка

dotnet add package MaxSharp --version 0.1.0-alpha

🚀 Быстрый старт

using MaxSharp.Core;
using MaxSharp.Core.Bot;
using MaxSharp.Core.Extensions;
using MaxSharp.Core.Models.Types;

// Создание клиента
var client = new MaxBotClient("YOUR_BOT_TOKEN");

// Отправка сообщения
var message = await client.SendTextMessageAsync(
    chatId: 123456789,
    text: "Привет, MAX! 👋",
    format: TextFormat.markdown);

// Сообщение с inline-кнопками
var buttons = new[]
{
    new[]
    {
        new InlineKeyboardButton { Type = "callback", Text = "Кнопка 1", Payload = "btn1" },
        new InlineKeyboardButton { Type = "callback", Text = "Кнопка 2", Payload = "btn2" }
    }
};

await client.SendTextMessageAsync(
    chatId: 123456789,
    text: "Выберите действие:",
    buttons: buttons);

✨ Возможности

🔧 Базовый URL

По умолчанию используется https://platform-api2.max.ru. Для подключения к другим окружениям передайте базовый URL явно:

var options = new MaxBotClientOptions("YOUR_TOKEN", baseUrl: "https://platform-api2.max.ru");
var client = new MaxBotClient(options);

⚙️ Конфигурация

var options = new MaxBotClientOptions(
    token: "YOUR_BOT_TOKEN",     // Токен бота (обязательно)
    baseUrl: "https://platform-api2.max.ru", // Базовый URL API
    maxRps: 30                    // Максимальное количество запросов в секунду
);

🔄 Обработка ошибок

try
{
    var message = await client.SendTextMessageAsync(chatId, text);
}
catch (RequestException ex)
{
    Console.WriteLine($"Ошибка API: {ex.HttpStatusCode} - {ex.Message}");
}

📝 Примеры

Полный пример бота для организации экскурсий доступен в папке samples/city-trip-bot.

⚠️ Лимиты API

MAX API ограничивает отправку сообщений: не более 2 в секунду на диалог.

🛠 Сборка и публикация

# Сборка пакета
dotnet build src/MaxSharp.Core/MaxSharp.Core.csproj -c Release

# Создание nupkg
dotnet pack src/MaxSharp.Core/MaxSharp.Core.csproj -c Release -o ./nupkgs

# Публикация (требуется NUGET_API_KEY)
dotnet nuget push ./nupkgs/MaxSharp.0.1.0-alpha.nupkg \
    --api-key YOUR_NUGET_API_KEY \
    --source https://api.nuget.org/v3/index.json

📄 Лицензия

MIT