Download the PHP package targethunter/max-php-sdk without Composer
On this page you can find all versions of the php package targethunter/max-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download targethunter/max-php-sdk
More information about targethunter/max-php-sdk
Files in targethunter/max-php-sdk
Package max-php-sdk
Short Description PHP SDK для API мессенджера MAX
License MIT
Informations about the package max-php-sdk
MAX PHP SDK
PHP SDK для работы с API мессенджера MAX. Этот пакет предоставляет удобный интерфейс для взаимодействия с MAX Bot API.
Установка
Установите пакет через Composer:
Требования
- PHP 7.4 или выше
- GuzzleHttp 7.5 или выше
- Расширение JSON
Быстрый старт
Инициализация клиента
Получение информации о боте
Модули API
SDK разделен на несколько модулей, для удобства использования. Модули реализованы так же, как в официальном API MAX.
1. Модуль Bots (Боты)
Управление информацией о боте.
Примеры:
2. Модуль Messages (Сообщения)
Работа с сообщениями.
Примеры:
3. Модуль Chats (Чаты)
Управление чатами и участниками.
Примеры:
4. Модуль Upload (Загрузка файлов)
Загрузка файлов в MAX.
Примеры:
5. Модуль Subscriptions (Подписки)
Управление webhook подписками.
Примеры:
Обработка ошибок
SDK автоматически обрабатывает ошибки от API MAX и преобразует их в читаемый формат. Все методы могут выбрасывать исключения MAXHttpException при ошибках сети или API.
Автоматическая обработка ошибок
SDK автоматически:
- Извлекает человекочитаемые сообщения об ошибках из ответов API
- Сохраняет HTTP статус код
- Сохраняет оригинальное исключение Guzzle для отладки
Типы ошибок
SDK обрабатывает различные форматы ошибок от MAX API:
message- основное сообщение об ошибкеerror.message- сообщение в объекте errorerror.description- описание ошибкиdescription- альтернативное поле описания
Если ответ не в формате JSON, SDK вернет сырое тело ответа.
Конфигурация
Базовый URL API
По умолчанию SDK использует базовый URL API: https://platform-api.max.ru/
Кастомный HTTP клиент
Вы можете создать собственный HTTP клиент и передать его в конструктор MAXRequest:
Кастомизация через наследование
Вы можете унаследоваться от MAXRequest и переопределить нужные методы:
Кастомный URL API
Кастомный класс исключений
Метод createException() — фабрика для создания исключений. Переопределите его, чтобы SDK бросал ваши доменные исключения вместо MAXHttpException:
Логика парсинга ответа API (извлечение человекочитаемого сообщения из JSON) остаётся в SDK — вы получаете готовое сообщение в параметре $message.
Полный пример использования
Лицензия
MIT License
Поддержка
Если у вас есть вопросы или проблемы, создайте issue в репозитории проекта.