Compare commits

..

5 Commits

Author SHA1 Message Date
Alex f788038189 Update doc 2026-07-05 13:57:03 +03:00
Alex 22b328b0c3 Update doc 2026-07-02 22:32:39 +03:00
Alex daa3d297da Update doc 2026-07-02 22:19:34 +03:00
Alex a40e47ebc0 Update doc 2026-07-02 22:17:38 +03:00
Alex 99f66483f3 Update doc 2026-07-02 22:13:24 +03:00
2 changed files with 62 additions and 13 deletions
+50 -1
View File
@@ -45,6 +45,55 @@ composer require bushlanov-dev/max-bot-api-client-php
### Использование
> [!NOTE]
> С 19 июля 2026 основной домен api изменится с platform-api.max.ru на platform-api2.max.ru и начнет использовать чебурнетовский сертификат!
> Вам необходимо либо установить сертификат, либо отключить его проверку, оба варианта описаны ниже.
Установка сертификата на примере ОС Ubuntu
```bash
# корневой сертификат
curl -k -O "https://gu-st.ru/content/Other/doc/russian_trusted_root_ca.cer"
# промежуточный сертификат
curl -k -O "https://gu-st.ru/content/Other/doc/russian_trusted_sub_ca.cer"
sudo cp russian_trusted_root_ca.cer /usr/local/share/ca-certificates/russian_trusted_root_ca.crt
sudo cp russian_trusted_sub_ca.cer /usr/local/share/ca-certificates/russian_trusted_sub_ca.crt
sudo update-ca-certificates
```
> [!TIP]
> **Гибкая настройка Guzzle**
> Мах часто меняют домен API а теперь еще и сертификат.
> Если вы не хотите или не можете установить сертификат на прямую в систему, можно собрать объект API с кастомным Guzzle клиентом и отключить проверку сертификата.
> Во всех остальных случаях достаточно минимального $api = new Api('YOUR_BOT_API_TOKEN');
```php
$guzzle = new \GuzzleHttp\Client([
'timeout' => 10,
'connect_timeout' => 5,
'read_timeout' => 10,
'headers' => ['User-Agent' => 'max-bot-api-client-php'],
'verify' => false, // Отключить проверку либо путь до сертификата '/path/to/cert.pem'
]);
$httpFactory = new \GuzzleHttp\Psr7\HttpFactory();
$client = new \BushlanovDev\MaxMessengerBot\Client(
accessToken: 'YOUR_BOT_API_TOKEN',
httpClient: $guzzle,
requestFactory: $httpFactory,
streamFactory: $httpFactory,
baseUrl: 'https://platform-api2.max.ru',
);
$api = new BushlanovDev\MaxMessengerBot\Api(
client: $client,
modelFactory: new BushlanovDev\MaxMessengerBot\ModelFactory(),
);
```
Отправка сообщения с клавиатурой
```php
@@ -136,7 +185,7 @@ $handler->handle();
#### Chats
- [x] `GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](./docs/README.md#Получение-списка-всех-чатов-бота)
- [x] ~~`GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](./docs/README.md#Получение-списка-всех-чатов-бота-deprecated)~~ (deprecated)
- [x] `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](./docs/README.md#Получение-информации-о-чате-по-ссылке)
- [x] `GET /chats/{chatId}` (`getChat`) - [*Получение информации о чате по ID.*](./docs/README.md#Получение-информации-о-чате-по-ID)
- [x] `PATCH /chats/{chatId}` (`editChat`) - [*Редактирование информации о чате.*](./docs/README.md#Редактирование-информации-о-чате)
+12 -12
View File
@@ -6,7 +6,7 @@
- `GET /me` (`getBotInfo`) - [*Получение информации о боте.*](#Получение-информации-о-боте)
- `PATCH /me` (`editBotInfo`) - [*Редактирование информации о боте.*](#Редактирование-информации-о-боте)
- [Чаты](#Чаты)
- `GET /chats` (`getChats`) - [*Получение списка всех чатов бота.*](#Получение-списка-всех-чатов-бота)
- ~~`GET /chats` (`getChats`)~~ - [*Получение списка всех чатов бота.*](#Получение-списка-всех-чатов-бота-deprecated) (deprecated)
- `GET /chats/{chatLink}` (`getChatByLink`) - [*Получение информации о чате по ссылке.*](#Получение-информации-о-чате-по-ссылке)
- `GET /chats/{chatId}` (`getChat`) - [*Получение информации о чате по ID.*](#Получение-информации-о-чате-по-ID)
- `PATCH /chats/{chatId}` (`editChat`) - [*Редактирование информации о чате.*](#Редактирование-информации-о-чате)
@@ -89,22 +89,22 @@ $guzzle = new \GuzzleHttp\Client([
'connect_timeout' => 5,
'read_timeout' => 10,
'headers' => ['User-Agent' => 'max-bot-api-client-php'],
// 'verify' => false, либо путь до сертификата '/path/to/cert.pem'
// 'verify' => false, // Отключить проверку либо путь до сертификата '/path/to/cert.pem'
]);
$httpFactory = new \GuzzleHttp\Psr7\HttpFactory();
$client = new \BushlanovDev\MaxMessengerBot\Client(
$accessToken,
$guzzle,
$httpFactory,
$httpFactory,
'https://platform-api2.max.ru',
accessToken: 'YOUR_BOT_API_TOKEN',
httpClient: $guzzle,
requestFactory: $httpFactory,
streamFactory: $httpFactory,
baseUrl: 'https://platform-api2.max.ru',
);
$api = new Api(
accessToken: 'YOUR_BOT_API_TOKEN',
$api = new BushlanovDev\MaxMessengerBot\Api(
client: $client,
modelFactory: new ModelFactory(),
logger: new YourPsrLogger(),
modelFactory: new BushlanovDev\MaxMessengerBot\ModelFactory(),
);
```
@@ -136,7 +136,7 @@ $botInfo = $api->editBotInfo(
## Чаты
### Получение списка всех чатов бота
### Получение списка всех чатов бота (deprecated)
Возвращает информацию о чатах, в которых участвовал бот.
Результат включает список чатов и маркер для перехода к следующей странице.