Отправка сообщений в Max с использованием PHP: полное руководство

Расширенные примеры отправки сообщений в Max через PHP

Ниже приведены подробные сценарии с кодом и ожидаемыми результатами. Все примеры предполагают наличие валидного токена и рабочего эндпоинта https://api.max.com/v1/messages.

Пример 1: Отправка сообщения с дополнительными параметрами (приоритет, тип)

$data = [
    'recipient' => 'user@example.com',
    'text' => 'Важное уведомление',
    'priority' => 'high',
    'type' => 'notification',
    'metadata' => ['source' => 'php-script']
];

$ch = curl_init('https://api.max.com/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($data, JSON_UNESCAPED_UNICODE),
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer TOKEN'
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 5
]);
$response = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

echo "HTTP-код: " . $info['http_code'] . "\n";
echo "Ответ: $response\n";

HTTP-код: 200
Ответ: {"success":true,"message_id":"msg_abc123","status":"queued"}

Пример 2: Отправка нескольких сообщений в одном запросе (batch)

Некоторые API Max поддерживают пакетную отправку. Ожидается массив сообщений.

$batch = [
    ['recipient' => 'alice@example.com', 'text' => 'Первое'],
    ['recipient' => 'bob@example.com', 'text' => 'Второе']
];

$client = new GuzzleHttp\Client(['base_uri' => 'https://api.max.com/']);
try {
    $response = $client->post('v1/messages/batch', [
        'json' => ['messages' => $batch],
        'headers' => ['Authorization' => 'Bearer TOKEN']
    ]);
    $result = json_decode($response->getBody(), true);
    print_r($result);
} catch (Exception $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Array
(
    [success] => 1
    [processed] => 2
    [failed] => 0
    [ids] => Array
        (
            [0] => msg_001
            [1] => msg_002
        )
)

Пример 3: Асинхронная отправка с помощью Guzzle Promises

Полезна при отправке большого количества сообщений без блокировки выполнения.

use GuzzleHttp\Client;
use GuzzleHttp\Promise;

$client = new Client(['base_uri' => 'https://api.max.com/']);
$promises = [];

$recipients = ['user1@example.com', 'user2@example.com', 'user3@example.com'];
foreach ($recipients as $index => $recipient) {
    $promises["msg_$index"] = $client->postAsync('/v1/messages', [
        'json' => ['recipient' => $recipient, 'text' => "Сообщение $index"],
        'headers' => ['Authorization' => 'Bearer TOKEN']
    ]);
}

$results = Promise\settle($promises)->wait();

foreach ($results as $key => $result) {
    if ($result['state'] === 'fulfilled') {
        $body = $result['value']->getBody()->getContents();
        echo "$key успешно: $body\n";
    } else {
        echo "$key ошибка: " . $result['reason']->getMessage() . "\n";
    }
}

msg_0 успешно: {"success":true,"message_id":"m01"}
msg_1 успешно: {"success":true,"message_id":"m02"}
msg_2 ошибка: Client error: 429 Too Many Requests

Пример 4: Отправка с логированием в файл

Для отслеживания всех запросов и ответов.

$logFile = '/var/log/max_messages.log';
$log = fopen($logFile, 'a');

$ch = curl_init();
$url = 'https://api.max.com/v1/messages';
$data = json_encode(['recipient' => 'test@test.com', 'text' => 'log test']);

curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Authorization: Bearer TOKEN'
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_VERBOSE => true,
    CURLOPT_STDERR => $log
]);

$response = curl_exec($ch);
$info = curl_getinfo($ch);
curl_close($ch);

fwrite($log, date('Y-m-d H:i:s') . ' URL: ' . $url . ' HTTP: ' . $info['http_code'] . ' Response: ' . $response . "\n");
fclose($log);

(в файле лога появится запись с временем и деталями запроса)

Пример 5: Отправка сообщения с файлом (multipart/form-data)

Если API Max принимает вложения, используйте CURLFile.

$file = new CURLFile('/path/to/image.jpg', 'image/jpeg', 'photo.jpg');
$data = [
    'recipient' => 'user@example.com',
    'text' => 'Фото в сообщении',
    'attachment' => $file
];

$ch = curl_init('https://api.max.com/v1/messages');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $data,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer TOKEN'
    ],
    CURLOPT_RETURNTRANSFER => true
]);
// Content-Type установится автоматически как multipart/form-data
$response = curl_exec($ch);
curl_close($ch);
echo $response;

{"success":true,"message_id":"msg_with_file","attachment_url":"https://max.com/files/photo.jpg"}