Интеграция сервисов Яндекса с помощью PHP

Расширенные примеры интеграции Яндекс API на PHP

Пример 1: полный цикл работы с Яндекс.Переводчиком (список языков, перевод, обработка ошибок)

Код ниже получает доступные направления перевода, переводит заданный текст и корректно обрабатывает возможные ошибки:

$apiKey = 'trnsl.1.1.201610...';

// Получение списка языков
$urlLangs = 'https://translate.yandex.net/api/v1.5/tr.json/getLangs?key=' . $apiKey . '&ui=ru';
$langsResponse = file_get_contents($urlLangs);
if ($langsResponse === false) {
    die('Ошибка получения списка языков');
}
$langsData = json_decode($langsResponse, true);
echo 'Доступные языки: ' . implode(', ', array_keys($langsData['langs'])) . "\n";

// Перевод текста
$text = 'Hello, world!';
$targetLang = 'ru';
$urlTranslate = 'https://translate.yandex.net/api/v1.5/tr.json/translate?key=' . $apiKey . '&text=' . urlencode($text) . '&lang=en-' . $targetLang;

$ch = curl_init($urlTranslate);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $result = json_decode($response, true);
    if (isset($result['text'][0])) {
        echo "Перевод: " . $result['text'][0] . "\n";
    } else {
        echo 'Нет поля text в ответе' . "\n";
        print_r($result);
    }
} elseif ($httpCode === 401) {
    echo 'Неверный API-ключ';
} elseif ($httpCode === 402) {
    echo 'Превышена квота';
} else {
    echo 'HTTP ошибка: ' . $httpCode;
}

Результат выполнения:

Доступные языки: af, am, ar, az, ba, be, bg, bn, bs, ca, ceb, cs, cy, da, de, el, en, eo, es, et, eu, fa, fi, fr, fy, ga, gd, gl, gu, ha, haw, he, hi, hmn, hr, ht, hu, hy, id, ig, is, it, iw, ja, jw, ka, kk, km, kn, ko, ku, ky, la, lb, lo, lt, lv, mg, mi, mk, ml, mn, mr, ms, mt, my, ne, nl, no, ny, or, pa, pl, ps, pt, ro, ru, sd, si, sk, sl, sm, sn, so, sq, sr, st, su, sv, sw, ta, te, tg, th, tk, tl, tr, tt, ug, uk, ur, uz, vi, xh, yi, yo, zu
Перевод: Привет, мир!

Пример 2: загрузка файла на Яндекс.Диск через REST API (создание папки, загрузка, проверка)

$token = 'ваш_oauth_токен';
$localFile = __DIR__ . '/example.txt';
$remoteFolder = 'disk:/Загрузки/';
$remoteFile = $remoteFolder . basename($localFile);

// Создание папки, если её нет
$urlCreate = 'https://cloud-api.yandex.net/v1/disk/resources?path=' . urlencode($remoteFolder);
$chCreate = curl_init($urlCreate);
curl_setopt($chCreate, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($chCreate, CURLOPT_RETURNTRANSFER, true);
curl_setopt($chCreate, CURLOPT_HTTPHEADER, ['Authorization: OAuth ' . $token]);
$respCreate = curl_exec($chCreate);
$httpCreate = curl_getinfo($chCreate, CURLINFO_HTTP_CODE);
curl_close($chCreate);

if ($httpCreate !== 201 && $httpCreate !== 204) {
    // 409 - папка уже существует
    if ($httpCreate === 409) {
        echo 'Папка уже существует' . "\n";
    } else {
        die('Ошибка создания папки: ' . $respCreate);
    }
}

// Получение ссылки для загрузки
$urlUpload = 'https://cloud-api.yandex.net/v1/disk/resources/upload?path=' . urlencode($remoteFile) . '&overwrite=true';
$chHref = curl_init($urlUpload);
curl_setopt($chHref, CURLOPT_RETURNTRANSFER, true);
curl_setopt($chHref, CURLOPT_HTTPHEADER, ['Authorization: OAuth ' . $token]);
$respHref = curl_exec($chHref);
$dataHref = json_decode($respHref, true);
curl_close($chHref);

if (isset($dataHref['href'])) {
    $href = $dataHref['href'];
    // Загрузка файла
    $chPut = curl_init($href);
    curl_setopt($chPut, CURLOPT_PUT, true);
    curl_setopt($chPut, CURLOPT_INFILE, fopen($localFile, 'r'));
    curl_setopt($chPut, CURLOPT_INFILESIZE, filesize($localFile));
    curl_setopt($chPut, CURLOPT_RETURNTRANSFER, true);
    $respPut = curl_exec($chPut);
    $httpPut = curl_getinfo($chPut, CURLINFO_HTTP_CODE);
    curl_close($chPut);
    if ($httpPut === 201) {
        echo 'Файл успешно загружен' . "\n";
    } else {
        echo 'Ошибка загрузки: ' . $respPut . "\n";
    }
} else {
    echo 'Не удалось получить ссылку для загрузки';
    print_r($dataHref);
}

Результат:

Папка уже существует
Файл успешно загружен

Пример 3: распознавание текста из изображения по URL через Yandex Vision

$iamToken = 'ваш_iam_токен';
$folderId = 'b1g...';
$imageUrl = 'https://example.com/document.jpg';

$body = json_encode([
    'folderId' => $folderId,
    'analyzeSpecs' => [
        [
            'content' => [
                'image' => [
                    'imageSource' => [
                        'imageUrl' => $imageUrl
                    ]
                ]
            ],
            'features' => [
                ['type' => 'TEXT_DETECTION']
            ]
        ]
    ]
]);

$url = 'https://vision.api.cloud.yandex.net/vision/v1/batchAnalyze';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $iamToken,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    $text = $data['results'][0]['textDetection']['text'] ?? 'Текст не найден';
    echo "Распознанный текст: \n" . $text;
} else {
    echo 'Ошибка: ' . $response;
}

Результат (пример):

Распознанный текст: 
Договор №123 от 01.01.2023

Пример 4: генерация ответа YandexGPT с системным сообщением

$iamToken = 'ваш_iam_токен';
$folderId = 'b1g...';

$messages = [
    ['role' => 'system', 'text' => 'Ты профессиональный PHP-разработчик.'],
    ['role' => 'user', 'text' => 'Напиши класс для работы с Яндекс API.']
];

$body = json_encode([
    'model' => 'yandexgpt',
    'generationOptions' => [
        'maxTokens' => 500,
        'temperature' => 0.6
    ],
    'messages' => $messages
]);

$url = 'https://llm.api.cloud.yandex.net/llm/v1/completion';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $iamToken,
    'x-folder-id: ' . $folderId,
    'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    $answer = $data['result']['alternatives'][0]['message']['text'] ?? '';
    echo 'Ответ YandexGPT: ' . $answer;
} else {
    echo 'Ошибка: ' . $response;
}

Результат (сгенерированный текст):

Ответ YandexGPT: Класс для работы с Яндекс API может включать методы для выполнения запросов, обработки ответов и управления ключами. Примерный каркас:

class YandexApiClient {
    private $apiKey;
    public function __construct($apiKey) {
        $this->apiKey = $apiKey;
    }
    public function request($method, $url, $data = []) {
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Api-Key ' . $this->apiKey]);
        // ...
    }
}