spree-api-v3

Installation
SKILL.md

Spree API v3

Before writing code

Fetch live docs:

  1. Fetch https://spreecommerce.org/docs/api-reference for the v3 API index.
  2. Fetch the OpenAPI spec for the Spree version you target — it ships per release. Find the link on the API reference page.
  3. Fetch the v5.4 announcement (https://spreecommerce.org/announcing-spree-commerce-5-4/) for the design rationale.
  4. Inspect the live Spree source under app/controllers/spree/api/v3/ for the canonical request/response shape per endpoint.
  5. Check the rate-limit configuration in config/initializers/spree.rb for the deployment you're targeting.

Conceptual Architecture

Two APIs, One Generation

API Path Auth Audience
Store API /api/v3/store/* Publishable key (pk_…) + per-user JWT bearer Customers, storefronts
Admin API /api/v3/admin/* Per-user API keys + OAuth2 (Doorkeeper) Admin, operations, server-to-server
Installs
1
GitHub Stars
33
First Seen
9 days ago
spree-api-v3 — orcaqubits/agentic-commerce-claude-plugins