spree-api-v3
Installation
SKILL.md
Spree API v3
Spree exposes two distinct API surfaces under /api/v3/:
| Surface | Path | Audience | Auth |
|---|---|---|---|
| Store API | /api/v3/store/* |
Storefronts, mobile apps, customers | Publishable key + optional JWT customer |
| Admin API | /api/v3/admin/* |
Back-office apps, integrations, admin SPAs | Secret key + scopes OR JWT admin + CanCanCan |
They share conventions (envelope shape, prefixed IDs, pagination) but have different auth, different default actions, and different exposed fields. This is the most-confused-about distinction in the API; cover it carefully.
Store API vs Admin API — the contract differences
Store API
Who calls it: customer browsers and apps. Public, untrusted clients.