koovod/max-api-php-client

Lightweight PHP client for the MAX Messenger API.

dev-main 2026-02-17 16:23 UTC

Requires

• php: ^8.1
• ext-curl: *

Requires (Dev)

• phpunit/phpunit: ^10.5

MIT

README

PHP SDK

В репозиторий добавлена легковесная PHP-библиотека MaxApiClient, которая инкапсулирует все методы, перечисленные в https://dev.max.ru/docs-api. Подключение выполняется через Composer (PSR-4 namespace MaxApi\). Клиент предоставляет единообразную обёртку над REST API MAX, отвечает за сериализацию JSON, установку заголовков авторизации и обработку ошибок.

Установка

composer install

Или добавьте репозиторий как зависимость в другом проекте и выполните composer require koovod/max-api-php-client. Требуется PHP 8.1+ и расширение ext-curl.

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

<?php

require __DIR__ . '/vendor/autoload.php';

use MaxApi\MaxApiClient;

$client = new MaxApiClient('Authorization: <token>');
$me = $client->getMe();
$client->sendMessage([
    'chat_id' => 12345,
    'text' => 'Привет, MAX!',
]);

Доступные методы клиента соответствуют разделам в https://dev.max.ru/docs-api: getMe, getChats, getChat, updateChat, deleteChat, sendChatAction, управление закреплёнными сообщениями, членством, подписками, загрузками, сообщениями, видео и callback-ответами. Каждый метод принимает ассоциативные массивы с параметрами, описанными в документации.

Тесты

Для проверки логики используйте

composer test

В окружении разработчика PHPUnit использует встроенный тестовый HTTP-хэндлер, поэтому реальные запросы в MAX не выполняются.