Versioning & Conventions

Versioning & Conventions

– Paths use integer ids where shown as {id}, {pid}, {vid}, {cid}, {aid}, {oid}, {rid}.

– Money fields in product/order payloads are typically integer cents (same as admin).

– Handlers and payloads match the store admin panel (/v1/admin/… core routes); this prefix is the stable external surface for developers.

– Keep tokens secret. Rotate credentials if a token is leaked. Prefer shop-scoped tokens with least privilege in your integration (one shop at a time).