App Proxy API

SaveLayer uses Shopify app proxy for the Online Store theme channel.

Route policy

The merchant-facing proxy URL is configured through Shopify app proxy settings. Internally, SaveLayer keeps all proxy handlers under one dedicated route namespace.

Current placeholder operations:

• POST /save
• POST /remove
• POST /toggle
• GET /list
• POST /batch

Request validation

All proxy routes are expected to:

• authenticate with Shopify's app proxy validation
• parse input with shared Zod schemas
• return a standard JSON success or error envelope

Error model

The API is documented around structured error codes instead of ad hoc strings. This keeps storefront integrations predictable and allows agencies to handle blocked states consistently.