Guides

The Harmon Storefront API lets you build your own ecommerce store: read the catalog, price a cart, and place orders. The base URL is api.harmoncommerce.com, and every endpoint is described in the API reference - these guides are the plain-language companion to it.

Start here

• Quickstart - your first API call in five minutes: get a key, ping, list products.
• Authentication & keys - publishable vs secret keys, and shopper tokens.
• Sandbox vs live - build against a sandbox key, then flip to live.

Core concepts

• Errors - partial responses (errors[]) and the hard-failure status table.
• Rate limits - per-key limits and Retry-After.
• Pagination & caching - page/page_size, ETag / If-None-Match, and updated_since deltas.
• Availability - coarse stock bands, never raw counts.

What this API doesn't do

• Read-only catalog, pricing, and stock. You can't change products, prices, or stock through this API - the only writes are shopper sign-up/login and cart/checkout.
• No online card payments yet. Checkout uses cash on delivery or credit terms; card payments are coming later.