REST API WooCommerce — это мощный инструмент, который позволяет подключить ваш магазин WooCommerce к внешним системам и сервисам.
В большинстве случаев, если вы не разработчик, для интеграции достаточно просто создать API-ключи и передать их в нужный сервис — после этого подключение будет готово.
В этом документе описаны базовые шаги работы с REST API со стороны владельца магазина. Более сложные технические детали доступны в документации для разработчиков.
Техническую документацию REST API можно найти на GitHub.
Требования
Постоянные ссылки WordPress должны быть включены в «человеко-понятном» виде. Настроить это можно в разделе:
Настройки → Постоянные ссылки
Рекомендуется использовать вариант «День и название», но подойдёт любой формат, кроме «Простые».
Создание API-ключей
REST API WooCommerce использует систему ключей для управления доступом. Эти ключи привязаны к конкретному пользователю сайта.
Чтобы создать или управлять ключами:
- Перейдите в WooCommerce → Настройки → Дополнительно → REST API
- Нажмите «Создать ключ API» или «Добавить ключ»
- Укажите описание ключа
- Выберите пользователя, для которого создаётся ключ
- Выберите уровень доступа:
- Чтение
- Запись
- Чтение/запись
- Нажмите «Сгенерировать ключ API»
После создания вы получите:
- Потребительский ключ (Consumer Key)
- Потребительский секрет (Consumer Secret)
Также может отображаться QR-код и ссылка для отзыва ключа.
Эти данные используются в стороннем приложении для подключения к вашему сайту. Иногда приложение также запрашивает адрес вашего сайта.
Устаревший REST API
Устаревший REST API больше не используется в WooCommerce. Сейчас WooCommerce работает напрямую через REST API WordPress.
Если он всё же необходим для старой интеграции, требуется установить дополнительный плагин «WooCommerce Legacy REST API».
Без этого плагина вебхуки и старые интеграции, использующие устаревший API, перестанут работать.
После установки плагина можно включить поддержку в разделе:
WooCommerce → Настройки → Дополнительно → Legacy API
Документация для разработчиков
Для проверки работы API можно выполнить тестовые запросы, например получить список заказов.
Полная документация доступна по ссылке: