Середа, 13:00
Фронтенд-розробник headless-магазину: «Товар додається, а після оновлення сторінки кошик порожній». Кожен запит до Store API приходить без Cart-Token, тож WooCommerce щоразу бачить нового гостя з новим порожнім кошиком.
Бекенд працює правильно. Він просто не знає, що це той самий покупець.
Мета
Після уроку ви працюєте з кошиком і checkout через Store API, зберігаєте сесію покупця між запитами і додаєте у відповідь власні дані.
Ключові поняття
- Store API — публічний REST для покупця:
/wp-json/wc/store/v1/(cart, cart/add-item, checkout, products) - Не потребує ключів, працює від імені поточного покупця (сесія або Cart-Token)
- Заголовок
Nonceдля запитів, що змінюють дані - Розширення відповіді:
woocommerce_store_api_register_endpoint_data()(ExtendSchema) - Відмінність від WC REST API v3: v3 — адмін-доступ з ключами, Store API — дії покупця
Схема
sequenceDiagram
participant B as Браузер / headless
participant S as Store API
participant C as WC()->cart
B->>S: GET /wc/store/v1/cart
S-->>B: cart + Nonce + Cart-Token
B->>S: POST /cart/add-item {id, quantity} + Nonce
S->>C: add_to_cart() + розрахунок
S-->>B: оновлений cart JSON
Код
Додати дані в позиції кошика Store API:
<?php
use Automattic\WooCommerce\StoreApi\Schemas\V1\CartItemSchema;
add_action( 'woocommerce_blocks_loaded', static function () {
woocommerce_store_api_register_endpoint_data( [
'endpoint' => CartItemSchema::IDENTIFIER,
'namespace' => 'my-plugin',
'data_callback' => static function ( array $cart_item ): array {
$product = $cart_item['data'];
return [ 'supplier_code' => (string) $product->get_meta( '_supplier_code' ) ];
},
'schema_callback' => static fn (): array => [
'supplier_code' => [ 'type' => 'string', 'readonly' => true ],
],
'schema_type' => ARRAY_A,
] );
} );
Запит з фронтенду (JS):
const res = await fetch( '/wp-json/wc/store/v1/cart' );
const nonce = res.headers.get( 'Nonce' );
const cart = await res.json();
console.log( cart.items[0].extensions['my-plugin'].supplier_code );
await fetch( '/wp-json/wc/store/v1/cart/add-item', {
method: 'POST',
headers: { 'Content-Type': 'application/json', Nonce: nonce },
body: JSON.stringify( { id: 41, quantity: 1 } ),
} );
Типові помилки
| Симптом | Причина | Виправлення |
|---|---|---|
401/403 на add-item | Немає заголовка Nonce | Взяти Nonce з відповіді GET /cart |
| Свої дані не видно в кошику | Реєстрація до завантаження блоків | Реєструвати на woocommerce_blocks_loaded |
| Headless-кошик «губиться» між запитами | Не передається Cart-Token | Зберігати і надсилати заголовок Cart-Token |
Слабка і сильна відповідь
Питання: Чим Store API відрізняється від WC REST API?
Слабка відповідь. Store API новіший.
Сильна відповідь. Це різні API для різних ролей. WC REST API v3 — для адміністрування й інтеграцій: ключі, повний доступ до товарів і замовлень. Store API — публічний, працює від імені покупця: кошик, checkout, каталог, без ключів, з Nonce і Cart-Token. Тому headless-фронт будують на Store API, а ERP-синк — на REST v3.
Чому друга сильніша: Кандидат пояснює різницю через ролі й безпеку і знає, коли що використовувати.
Практичне завдання
Зробіть «кошик» на чистому JS: отримайте кошик, додайте товар, змініть кількість, видаліть позицію через Store API. Додайте у відповідь кошика своє поле через ExtendSchema. Запити спершу спробуйте в терміналі.
Питання з інтерв'ю
Ні, це публічний API покупця. Для змін потрібен заголовок Nonce (захист від CSRF) і сесія або Cart-Token.
Через woocommerce_store_api_register_endpoint_data() для потрібного ендпоінта (кошик, позиція кошика). Дані з'являться в полі extensions.<namespace>.
Так, це його основний сценарій разом з блоками. Але оплата на зовнішньому фронті залежить від платіжного шлюзу: не всі шлюзи підтримують оплату через Store API.