Add editBotCommands for PATCH /me/commands, deprecate editBotInfo

The API no longer accepts PATCH /me: it answers "Path /me is not
recognized", so editBotInfo() fails, including for commands. Commands
now have their own endpoint, PATCH /me/commands (editMyCommands in the
official schema); bot name, description and photo are edited on the
MAX partner platform.

- Api::editBotCommands(BotCommand[]): BotCommandsInfo
- BotCommandsInfo model and ModelFactory::createBotCommandsInfo()
- editBotInfo() and BotPatch marked @deprecated
- README coverage map and docs updated
This commit is contained in:
Timofey
2026-09-28 00:08:35 +05:00
parent bf5219af7a
commit ca5ed4c100
9 changed files with 213 additions and 3 deletions
+18 -2
View File
@@ -4,7 +4,8 @@
- [Инициализация бота](#Инициализация-бота)
- [Информация о боте](#Информация-о-боте)
- `GET /me` (`getBotInfo`) - [*Получение информации о боте.*](#Получение-информации-о-боте)
- `PATCH /me` (`editBotInfo`) - [*Редактирование информации о боте.*](#Редактирование-информации-о-боте)
- `PATCH /me/commands` (`editBotCommands`) - [*Редактирование команд бота.*](#Редактирование-команд-бота)
- ~~`PATCH /me` (`editBotInfo`)~~ - [*Редактирование информации о боте.*](#Редактирование-информации-о-боте-deprecated) (deprecated)
- [Чаты](#Чаты)
- ~~`GET /chats` (`getChats`)~~ - [*Получение списка всех чатов бота.*](#Получение-списка-всех-чатов-бота-deprecated) (deprecated)
- `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](#Получение-информации-о-чате-по-ссылке)
@@ -119,7 +120,22 @@ $api = new BushlanovDev\MaxMessengerBot\Api(
$botInfo = $api->getBotInfo();
```
### Редактирование информации о боте
### Редактирование команд бота
Задаёт команды, которые пользователь видит подсказками, когда набирает «/». Не больше 32 команд, описание команды
необязательно.
```php
$botCommands = $api->editBotCommands([
new BotCommand('start', 'Начать'),
new BotCommand('help', 'Помощь'),
]);
```
### Редактирование информации о боте (deprecated)
API больше не принимает `PATCH /me` и отвечает `Path /me is not recognized`. Команды задаются методом
[`editBotCommands`](#Редактирование-команд-бота), имя, описание и аватар бота — на платформе MAX для партнёров.
Обратите внимание, что данный метод отправляется PATCH запросом. Это значит, что будут обновлены только переданные
поля.