spree-legacy-api-v2
Installation
SKILL.md
Spree API v2 — Legacy
Default recommendation: don't build new things on v2. Spree 5.4+ ships API v3 as the future-direction API; v2 still works but is feature-frozen. New endpoints, new auth modes (publishable + secret + JWT), prefixed IDs, expand, the typed SDKs — all v3. New integrations should start on v3.
This skill exists for two real reasons:
- You inherited a v2 integration and need to maintain it.
- You're migrating from v2 to v3 and need to know what changed.
If neither applies, use the spree-api-v3 skill instead.
What v2 looks like
Two distinct API surfaces under /api/v2/:
| Surface | Path | Audience |
|---|---|---|
| Storefront API | /api/v2/storefront/* |
Customer-facing — carts, products, checkout |
| Platform API | /api/v2/platform/* |
Admin/back-office — full CRUD |