Интеграция PHP-приложений с телеком-сервисами МТС

Расширенные примеры интеграции МТС API на PHP

Пример 1: Класс-обертка для работы с МТС API

Создадим класс MtsApi, который инкапсулирует методы отправки SMS, проверки баланса и статуса доставки.

class MtsApi {
    private $client;
    private $apiKey;

    public function __construct($apiKey, $baseUri = 'https://api.mts.ru/') {
        $this->apiKey = $apiKey;
        $this->client = new \GuzzleHttp\Client([
            'base_uri' => $baseUri,
            'headers' => [
                'X-API-Key' => $apiKey,
                'Content-Type' => 'application/json',
                'Accept' => 'application/json'
            ]
        ]);
    }

    public function sendSms($phone, $message) {
        $response = $this->client->post('/sms/send', [
            'json' => ['phone' => $phone, 'text' => $message]
        ]);
        return json_decode($response->getBody(), true);
    }

    public function getBalance($account) {
        $response = $this->client->post('/account/balance', [
            'json' => ['account' => $account]
        ]);
        return json_decode($response->getBody(), true);
    }

    public function getDeliveryStatus($messageId) {
        $response = $this->client->get('/sms/status', [
            'query' => ['messageId' => $messageId]
        ]);
        return json_decode($response->getBody(), true);
    }
}

// Использование
$api = new MtsApi('ваш_ключ');
$result = $api->sendSms('79123456789', 'Привет!');
print_r($result);

Array ( [success] => 1 [messageId] => abc123 )

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

Guzzle поддерживает асинхронные запросы, что ускоряет массовую отправку.

use GuzzleHttp\Client;
use GuzzleHttp\Promise;

$client = new Client(['base_uri' => 'https://api.mts.ru/']);
$apiKey = 'ваш_ключ';
$phones = ['79111111111', '79222222222', '79333333333'];
$promises = [];

foreach ($phones as $phone) {
    $promises[$phone] = $client->postAsync('/sms/send', [
        'headers' => ['X-API-Key' => $apiKey],
        'json' => ['phone' => $phone, 'text' => 'Массовая рассылка']
    ]);
}

$results = Promise\settle($promises)->wait();
foreach ($results as $phone => $result) {
    if ($result['state'] === Promise\Fulfilled) {
        $body = $result['value']->getBody()->getContents();
        echo "{$phone}: успешно, ответ: {$body}\n";
    } else {
        echo "{$phone}: ошибка - {$result['reason']}\n";
    }
}

79111111111: успешно, ответ: {"success":true,"messageId":"id1"}
79222222222: успешно, ответ: {"success":true,"messageId":"id2"}
79333333333: ошибка - cURL error 28: Connection timed out

Пример 3: Получение детализации звонков (CSV) и парсинг

API может возвращать файлы. Пример загрузки детализации и сохранения на диск.

$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mts.ru/cdr/download', [
    'headers' => ['X-API-Key' => 'ключ'],
    'json' => ['dateFrom' => '2023-01-01', 'dateTo' => '2023-01-31']
]);
$csv = $response->getBody()->getContents();
file_put_contents('cdr_2023_01.csv', $csv);
// Парсинг CSV
$rows = array_map('str_getcsv', explode("\n", $csv));
array_shift($rows); // удаляем заголовок
foreach ($rows as $row) {
    if (count($row) >= 3) {
        echo "Звонок: {$row[0]}, длительность: {$row[1]} сек, стоимость: {$row[2]} руб.\n";
    }
}

Звонок: 79123456789, длительность: 120 сек, стоимость: 1.50 руб.
Звонок: 79234567890, длительность: 45 сек, стоимость: 0.75 руб.

Пример 4: Использование OAuth 2.0 для доступа к API МТС

Если API требует авторизации через токен, получаем его по логину/паролю.

$client = new GuzzleHttp\Client();
$response = $client->post('https://api.mts.ru/oauth/token', [
    'form_params' => [
        'grant_type' => 'password',
        'client_id' => 'ваш_client_id',
        'client_secret' => 'секрет',
        'username' => 'логин',
        'password' => 'пароль'
    ]
]);
$tokenData = json_decode($response->getBody(), true);
$accessToken = $tokenData['access_token'];

// Далее используем токен в заголовках
$response = $client->get('https://api.mts.ru/account/info', [
    'headers' => ['Authorization' => 'Bearer ' . $accessToken]
]);
echo $response->getBody();

{"account":"12345","balance":150.00,"tariff":"Безлимит"}