Как создать автоматический импорт из внешнего REST API в WordPress

Автоматический импорт данных из внешних REST API в WordPress — востребованная задача, особенно когда нужно регулярно обновлять контент или товары без ручного вмешательства. В этой статье подробно разберём, как реализовать такой импорт с помощью собственного кода и лучших практик, а также рассмотрим примеры популярных плагинов для упрощения задачи.

Почему важен автоматический импорт из REST API

В современных проектах часто требуется интеграция с внешними сервисами — это может быть поставщик товаров, новости, база данных или CRM. Ручной импорт данных неудобен, занимает много времени и приводит к ошибкам. Автоматизация позволяет регулярно обновлять содержимое сайта по расписанию, экономя ресурсы и обеспечивая актуальность информации.

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

Основные этапы создания автоматического импорта из REST API

Рассмотрим ключевые шаги, которые нужно реализовать:

• Получение данных из внешнего REST API (GET-запрос с авторизацией, если нужно);
• Обработка полученных данных (парсинг JSON, фильтрация, валидация);
• Создание или обновление записей (постов, кастомных типов, пользовательских метаданных);
• Обработка ошибок и логирование;
• Запуск импорта по расписанию (WP-Cron);
• Оптимизация и безопасность (кеширование, защита от дублей).

Пример создания автоматического импорта в WordPress с кодом

Создадим базовый пример функции для импорта постов из внешнего API с помощью wp_remote_get и cron-задачи.

1. Функция получения и обработки данных

function wpcoding_fetch_and_import_posts() {
    $response = wp_remote_get('https://example.com/api/posts');
    if (is_wp_error($response)) {
        error_log('WPCoding Import Error: ' . $response->get_error_message());
        return;
    }
    $body = wp_remote_retrieve_body($response);
    $data = json_decode($body, true);
    if (empty($data) || !is_array($data)) {
        error_log('WPCoding Import Error: Invalid API response');
        return;
    }

    foreach ($data as $item) {
        // Проверка обязательных полей
        if (empty($item['title']) || empty($item['content'])) {
            continue;
        }

        // Проверяем, есть ли уже пост с таким уникальным внешним ID
        $existing = get_posts([
            'meta_key' => 'wpcoding_external_id',
            'meta_value' => $item['id'],
            'post_type' => 'post',
            'post_status' => 'any'
        ]);

        $post_data = [
            'post_title' => sanitize_text_field($item['title']),
            'post_content' => wp_kses_post($item['content']),
            'post_status' => 'publish',
            'post_type' => 'post'
        ];

        if ($existing) {
            // Обновляем существующий пост
            $post_data['ID'] = $existing[0]->ID;
            $post_id = wp_update_post($post_data);
        } else {
            // Создаём новый пост
            $post_id = wp_insert_post($post_data);
            if (!is_wp_error($post_id)) {
                add_post_meta($post_id, 'wpcoding_external_id', $item['id'], true);
            }
        }
    }
}

2. Добавление задачи в WP-Cron для регулярного запуска

Чтобы импорт происходил автоматически, добавим событие в расписание WordPress.

function wpcoding_schedule_import() {
    if (!wp_next_scheduled('wpcoding_import_event')) {
        wp_schedule_event(time(), 'hourly', 'wpcoding_import_event');
    }
}
add_action('wp', 'wpcoding_schedule_import');

add_action('wpcoding_import_event', 'wpcoding_fetch_and_import_posts');

Этот код создает задачу, которая будет запускаться каждый час и импортировать новые данные.

Безопасность и оптимизация автоматического импорта

При работе с внешними API важно учитывать несколько моментов:

• Авторизация API. Если API требует ключ или токен, добавьте его в заголовки запроса с помощью параметра wp_remote_get. Например:

$response = wp_remote_get('https://example.com/api/posts', [
    'headers' => [
        'Authorization' => 'Bearer ' . YOUR_API_TOKEN
    ]
]);

• Обработка ошибок. Логируйте ошибки и уведомляйте админа, чтобы вовремя реагировать на сбои.
• Кеширование. Если API медленный, используйте transient API для кеширования результатов между запросами.
• Защита от дублей. Всегда проверяйте уникальные идентификаторы и обновляйте существующие записи, чтобы не создавать дубликаты.
• Оптимизация WP-Cron. На больших сайтах стандартный WP-Cron может работать нестабильно, стоит рассмотреть системный cron с wp-cli для запуска задачи.

Использование плагинов для автоматизации импорта

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

• WP All Import — мощный инструмент для импорта XML и CSV, поддерживает REST API через кастомные решения.
• Clearfy Pro — плагин для оптимизации и безопасности, поможет оптимизировать работу Cron и уменьшить нагрузку.

Расширение функционала: импорт кастомных типов записей и метаданных

Если требуется импортировать не стандартные посты, а кастомные типы записей или метаданные, достаточно в функции wpcoding_fetch_and_import_posts изменить параметр post_type и добавить сохранение метаданных:

// Пример для кастомного типа 'product'
$post_data['post_type'] = 'product';

// Добавление произвольных полей
update_post_meta($post_id, '_price', sanitize_text_field($item['price']));

Это позволит гибко адаптировать импорт под любые задачи.

Заключение

Автоматический импорт данных из внешнего REST API — мощный инструмент для расширения возможностей WordPress сайта. Создание собственного решения с использованием wp_remote_get и WP-Cron дает полный контроль над процессом, а использование проверенных плагинов позволяет сэкономить время. Главное — всегда учитывать безопасность, обработку ошибок и производительность, чтобы импорт работал стабильно и без сбоев.