Дополнение представляет собой REST API эндпоинты для плагина Flexible Subscriptions. Оно открывает прямой доступ к данным подписок в формате JSON через стандартный WordPress REST API.
Модуль разработан с полной оглядкой на WooCommerce Subscriptions API: использует ту же структуру ответов, те же поля, эндпоинты и методы аутентификации. Это позволяет переносить существующие сторонние интеграции, мобильные приложения и скрипты с минимальными правками.
Ключевые возможности:
- Автоматическое создание подписок: прямого метода POST для создания подписки нет. Процесс происходит автоматически при оформлении стандартного заказа через POST / WordPress-json/wc/v3/orders с подписочным товаром в line_items.
- Управление параметрами: через API можно менять статус подписки, ключевые даты (начало, следующий платёж, окончание триала, завершение), интервалы и периоды списаний (billing_period и billing_interval), данные плательщика/доставки, позиции и метаданные.
- Просмотр связанных заказов: выгрузка истории первичных заказов и продлений со статусами взаимосвязи (original, renewal, switch, resubscribe).
- Заметки к подпискам: полноценная работа с внутренними примечаниями (создание, получение, удаление).
Базовый URL: / WordPress-json/wc/v3/subscriptions:
- GET /subscriptions/<id> — получение подробной информации по конкретной подписке.
- GET /subscriptions — получение списка подписок с поддержкой фильтрации (по статусам active, on-hold, cancelled и др., клиенту, товару, датам), пагинации и сортировки.
- PUT /subscriptions/<id> — обновление параметров и статусов подписки.
- DELETE /subscriptions/<id>?force=true — удаление подписки (параметр force=true отвечает за безвозвратное удаление).
- GET /subscriptions/<id>/orders — получение списка связанных заказов (первичных и продлений).
- GET|POST /subscriptions/<id>/notes — работа с примечаниями и заметками к подписке.
- Аутентификация: стандартная для WooCommerce REST API через ключи consumer_key и consumer_secret (Basic Auth / HTTPS).
- Зависимости: требуется установленный WordPress, WooCommerce и базовый плагин Flexible Subscriptions.
- Назначение: идеально подходит для связки сайта с внешними CRM-системами, учетными сервисами, SaaS-платформами, мобильными приложениями и headless-фронтендами.
