poocommerce-store-api

name	poocommerce-store-api
description	Add or modify routes in the PooCommerce Store API (`/wc/store/v1/*`). Use when creating new Store API endpoints, modifying existing ones, or designing the schemas blocks and external integrations consume. Covers authentication, REST URL design, schema/response alignment, variation handling, idempotency, and common pitfalls.

PooCommerce Store API

The Store API is the public REST surface used by Woo blocks (Cart, Checkout, Mini-Cart) and external integrations. It lives under /wc/store/v1/* and has its own conventions distinct from the older /wc/v3/* admin REST API.

When to use this skill

• Adding a new route under /wc/store/v1/.
• Modifying an existing route's response shape, status codes, or argument schema.
• Designing the schema for a new resource the frontend will consume.
• Wiring a block (or iAPI store) to a Store API endpoint.

This skill complements poocommerce-backend-dev (general PHP conventions) and poocommerce-performance (cache priming patterns). Read those first for general conventions; this skill covers Store-API-specific decisions.

Topics

• authentication.md — permission_callback styles, nonce enforcement via AbstractCartRoute, when to extend which abstract.
• rest-conventions.md — Path/body/query separation, collection vs item vs action routes, status codes, idempotency.
• schema-design.md — Schema as public contract, field discipline, response-shape alignment.
• variation-handling.md — Server-authoritative variation reconciliation.
• performance.md — Where to apply cache priming in Store API responses. Cross-links to for the underlying patterns.