Урок 4.2. Store API

Середа, 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
<?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):

JAVASCRIPT
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. Запити спершу спробуйте в терміналі.

curl — Module 4. Cart and Checkout

Питання з інтерв'ю

Ні, це публічний API покупця. Для змін потрібен заголовок Nonce (захист від CSRF) і сесія або Cart-Token.

Через woocommerce_store_api_register_endpoint_data() для потрібного ендпоінта (кошик, позиція кошика). Дані з'являться в полі extensions.<namespace>.

Так, це його основний сценарій разом з блоками. Але оплата на зовнішньому фронті залежить від платіжного шлюзу: не всі шлюзи підтримують оплату через Store API.

Save your progress

Sign in or create a free account to mark lessons as completed and continue the whole course. You will come back to this lesson.