App Bridge
Embed your application directly in the Cartly merchant admin using iframe-based integration.
Architecture
App Bridge apps run inside an iframe within the Cartly admin panel. Communication between your app and the Cartly admin happens via postMessage.
Session Tokens
When your app loads in the iframe, Cartly provides a session token via query parameter. Use this token to authenticate API requests on behalf of the merchant.
App API Endpoints
Available endpoints for OAuth-authenticated apps
| Name | Type | Required | Description |
|---|---|---|---|
| GET /apps/api/shop | shop:read | No | Get current shop info |
| GET /apps/api/products | products:read | No | List shop products |
| GET /apps/api/orders | orders:read | No | List shop orders |
| GET /apps/api/customers | customers:read | No | List shop customers |
| POST /apps/api/metafields | metafields:write | No | Create or update a metafield |
| GET /apps/api/metafields | metafields:read | No | List metafields for namespace |