Как добавить вывод данных из внешнего API в WordPress: практическое руководство

Автор: Виктор Попов | Опубликовано: 13.11.2025

В современном веб-разработке часто возникает необходимость интегрировать сторонние сервисы, получая и отображая данные из внешних API прямо на сайте WordPress. В этой статье мы рассмотрим, как правильно запросить данные из внешнего API, обработать их и вывести на страницу вашего сайта, используя собственные функции и плагины.

Что такое внешнее API и зачем его использовать в WordPress

API (Application Programming Interface) — программный интерфейс, который позволяет получать доступ к данным и функциям сторонних сервисов. Например, это может быть API погоды, курсов валют, новостных лент или CRM-систем.

В WordPress интеграция с API позволяет расширить функционал сайта, сделать контент динамическим и актуальным без ручного обновления. Однако при работе с внешними API важно учитывать производительность, безопасность и обработку ошибок.

Основные этапы интеграции внешнего API в WordPress

Чтобы вывести данные из внешнего API, необходимо пройти несколько шагов:

Отправить HTTP-запрос к API с помощью стандартных функций WordPress.
Обработать полученный ответ, обычно в формате JSON.
Вывести данные на сайте в нужном формате.
Обеспечить кеширование и безопасность запросов.

Рассмотрим каждый этап подробно.

Отправка запроса к внешнему API через wp_remote_get

WordPress предоставляет удобную обёртку над HTTP-запросами — функцию wp_remote_get(). Она упрощает процесс и автоматически обрабатывает множество нюансов.

Пример запроса к публичному API погоды OpenWeatherMap:

function wpcorp_get_weather_data($city) {
    $api_key = 'ваш_ключ_api';
    $url = 'https://api.openweathermap.org/data/2.5/weather?q=' . urlencode($city) . '&appid=' . $api_key . '&units=metric&lang=ru';

    $response = wp_remote_get($url);
    if (is_wp_error($response)) {
        return false; // Ошибка запроса
    }

    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);

    if (empty($data) || isset($data['cod']) && $data['cod'] != 200) {
        return false; // Некорректный ответ
    }

    return $data;
}

В этом примере мы запросили данные о погоде по названию города. Функция возвращает массив с данными или false при ошибке.

Обработка и вывод данных из API на странице WordPress

После получения данных нужно корректно вывести их пользователю. Для этого создадим шорткод, который можно вставить в любую страницу или запись.

function wpcorp_weather_shortcode($atts) {
    $atts = shortcode_atts(array(
        'city' => 'Moscow',
    ), $atts, 'wpcorp_weather');

    $data = wpcorp_get_weather_data($atts['city']);
    if (!$data) {
        return '<p>Данные о погоде временно недоступны.</p>';
    }

    $output = '<div class="wpcorp-weather">';
    $output .= '<h3>Погода в ' . esc_html($data['name']) . '</h3>';
    $output .= '<p>Температура: ' . esc_html($data['main']['temp']) . ' °C</p>';
    $output .= '<p>Описание: ' . esc_html($data['weather'][0]['description']) . '</p>';
    $output .= '<p>Влажность: ' . esc_html($data['main']['humidity']) . '%</p>';
    $output .= '</div>';

    return $output;
}
add_shortcode('wpcorp_weather', 'wpcorp_weather_shortcode');

Теперь, добавив в контент сайта шорткод [wpcorp_weather city="Saint Petersburg"], вы увидите актуальную погоду для указанного города.

Кеширование результатов API-запросов в WordPress

Для снижения нагрузки на внешний сервис и ускорения загрузки сайта важно кешировать результаты запросов. В WordPress для этого прекрасно подходит функция set_transient().

Добавим кеширование в функцию получения данных:

function wpcorp_get_weather_data($city) {
    $cache_key = 'wpcorp_weather_' . md5($city);
    $cached = get_transient($cache_key);
    if ($cached !== false) {
        return $cached;
    }

    $api_key = 'ваш_ключ_api';
    $url = 'https://api.openweathermap.org/data/2.5/weather?q=' . urlencode($city) . '&appid=' . $api_key . '&units=metric&lang=ru';

    $response = wp_remote_get($url);
    if (is_wp_error($response)) {
        return false;
    }

    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);

    if (empty($data) || isset($data['cod']) && $data['cod'] != 200) {
        return false;
    }

    set_transient($cache_key, $data, HOUR_IN_SECONDS);

    return $data;
}

Теперь данные будут запрашиваться не чаще одного раза в час, что экономит трафик и ускоряет работу сайта.

Обзор полезных плагинов для работы с внешними API в WordPress

Если вы не хотите писать свой код с нуля, существует несколько плагинов, которые помогут интегрировать внешние API:

WPGetAPI — простой и мощный плагин для подключения любых REST API с возможностью создания шорткодов и виджетов.
REST API Client — позволяет тестировать и использовать REST API прямо из админки WordPress.
WP All Import — подходит для импорта данных из внешних источников, включая API, в записи и пользовательские типы.

Эти инструменты облегчают работу с API без глубоких знаний программирования.

Итоги и полезные советы

Интеграция внешних API в WordPress — мощный инструмент для расширения функционала вашего сайта. Используя wp_remote_get(), шорткоды и кеширование, вы сможете быстро и эффективно выводить актуальные данные. При необходимости можно использовать готовые плагины для упрощения задачи.

Обязательно тестируйте работу функций на тестовом сайте, а затем переносите на боевой. И не забывайте о безопасности и производительности!

Как добавить вывод данных из внешнего API в WordPress