Swell vs Wix Stores and eCommerce API

Swell

Live /:models schema with field types and descriptions for every store. One full-access secret key per environment, with no scoped or read-only key.

Wix Stores and eCommerce API

The developer docs are served as Markdown with an llms.txt index, and API keys carry permission scopes and a site restriction. No numeric REST rate limit or OpenAPI file was found, and status.wix.com records a platform-wide incident of 3 hours 17 minutes on 1 August 2026. A person must create the account and the key.

Swell

1. Call GET /:models once and cache it. It's the ground truth for custom fields
2. Check result.errors after every write. A failed validation still returns 200
3. Use $set to replace an array. A plain PUT merges arrays by element id and never shrinks them
4. Use an sk_test_ key while testing. A bare sk_ prefix is live
5. Keep expand and include small. Each level past the first three points adds rate-limit weight

Wix Stores and eCommerce API

1. Send the API key in Authorization with wix-site-id for site calls or wix-account-id for account calls, never both
2. Fetch the product first and pass product.revision on every Catalogue V3 update, or the call fails with 409
3. Use Cart V2 for new work. The older eCommerce Cart and Checkout APIs were deprecated on 5 August 2026
4. Request cursorPaging.limit of at most 100 on Query Products and use Search Products for lookups by name
5. Over MCP, read the method page with ReadFullDocsArticle before CallWixSiteAPI. Responses are cut at 50,000 characters by default